语言

EditContext 类

定义

保存与数据编辑过程相关的元数据,例如用于指示哪些字段已修改和当前验证消息集的标志。

public ref class EditContext sealed
public sealed class EditContext
type EditContext = class
Public NotInheritable Class EditContext
继承
EditContext

构造函数

名称 说明
EditContext(Object)

构造 . 的 EditContext实例。

属性

名称 说明
Model

获取此 EditContext对象的模型对象。

Properties

获取与此实例关联的任意属性的集合。

ShouldUseFieldIdentifiers

获取是否应为 <输入> 元素生成字段标识符。

方法

名称 说明
Field(String)

FieldIdentifier提供与此 EditContext's Model上的指定字段名称相对应的字段名称。

GetValidationMessages()

获取所有字段中的当前验证消息。

此方法不执行验证本身。 它仅返回先前验证操作确定的消息。

GetValidationMessages(Expression<Func<Object>>)

获取指定字段的当前验证消息。

此方法不执行验证本身。 它仅返回先前验证操作确定的消息。

GetValidationMessages(FieldIdentifier)

获取指定字段的当前验证消息。

此方法不执行验证本身。 它仅返回先前验证操作确定的消息。

IsModified()

确定是否修改了其中 EditContext 的任何字段。

IsModified(Expression<Func<Object>>)

确定此 EditContext 字段中的指定字段是否已修改。

IsModified(FieldIdentifier)

确定此 EditContext 字段中的指定字段是否已修改。

IsValid(Expression<Func<Object>>)

确定此 EditContext 字段中的指定字段是否没有关联的验证消息。

IsValid(FieldIdentifier)

确定此 EditContext 字段中的指定字段是否没有关联的验证消息。

IsValidationFaulted()

如果 true 最近的表单级传递出错(注册的验证任务引发),而不是仅仅生成验证消息,则返回。 随后成功的传递将清除它;调用方取消的 ValidateAsync(CancellationToken) 传递会保留它。 对于每个字段故障, IsValidationFaulted(FieldIdentifier) 请使用重载。

IsValidationFaulted(FieldIdentifier)

如果 true 指定的字段的最后一个异步验证出错(引发非取消异常),则返回。

IsValidationFaulted<TField>(Expression<Func<TField>>)

返回 true 表达式最后一次异步验证错误标识 accessor 的字段(引发非取消异常)。

IsValidationPending()

如果 true 窗体级 ValidateAsync(CancellationToken) 通行证当前处于外部测试状态,则返回用于驱动窗体范围的 UI,例如禁用提交按钮。 不考虑每个字段挂起的任务;将 IsValidationPending(FieldIdentifier) 重载用于这些重载。

IsValidationPending(FieldIdentifier)

如果指定的字段具有挂起的异步验证任务,则返回 true 。 任务保持“挂起”,直到框架的观察者解决了其结果,因此保证等待此 false 任务的使用者也会看到最终 IsValidationFaulted(FieldIdentifier) 值。

IsValidationPending<TField>(Expression<Func<TField>>)

返回 true 表达式标识的 accessor 字段是否具有挂起的异步验证任务。

MarkAsUnmodified()

清除此 EditContext范围内的所有修改标志。

MarkAsUnmodified(FieldIdentifier)

清除可为指定字段跟踪的任何修改标志。

NotifyFieldChanged(FieldIdentifier)

指示指定字段的值已更改。

NotifyValidationStateChanged()

表明验证状态的某些方面发生了变化。

RegisterAsyncFieldValidator(FieldIdentifier, Func<CancellationToken,Task>)

注册特定字段的异步验证。 将 validator 立即调用此 CancellationToken 对象的 EditContext拥有项,并跟踪返回 Task 的项 IsValidationPending(FieldIdentifier) 和 IsValidationFaulted(FieldIdentifier)。 已跟踪字段的验证已取消并替换。

Validate()
已过时.

同步验证此 EditContext 情况。

ValidateAsync(CancellationToken)

以异步方式验证此 EditContext 情况,等待处理程序通过 AddAsyncValidator(Func<CancellationToken,Task>)注册的任何验证任务。

事件

名称 说明
OnFieldChanged

字段值更改时引发的事件。

OnValidationRequested

请求验证时引发的事件。 验证程序组件订阅此事件以执行验证。

OnValidationStateChanged

验证状态发生更改时引发的事件。

扩展方法

名称 说明
AddDataAnnotationsValidation(EditContext)
已过时.

向 . EditContext. 添加 DataAnnotations 验证支持。

EnableDataAnnotationsValidation(EditContext, IServiceProvider)

启用对 .. 的 EditContextDataAnnotations 验证支持。

EnableDataAnnotationsValidation(EditContext)
已过时.

启用对 .. 的 EditContextDataAnnotations 验证支持。

FieldCssClass(EditContext, FieldIdentifier)

获取一个字符串,该字符串指示指定字段的状态作为 CSS 类。

FieldCssClass<TField>(EditContext, Expression<Func<TField>>)

获取一个字符串,该字符串指示指定字段的状态作为 CSS 类。 这将包括“modified”、“valid”或“invalid”的一些组合,具体取决于字段的状态。

SetFieldCssClassProvider(EditContext, FieldCssClassProvider)

将提供的 FieldCssClassProvider 与提供的 EditContext。 这将自定义在 . 中使用的 EditContext字段 CSS 类名。

适用于