ExceptionValidationRule 类

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

表示用于检查绑定源属性更新过程中抛出的异常的规则。

public ref class ExceptionValidationRule sealed : System::Windows::Controls::ValidationRule

public sealed class ExceptionValidationRule : System.Windows.Controls.ValidationRule

type ExceptionValidationRule = class
    inherit ValidationRule

Public NotInheritable Class ExceptionValidationRule
Inherits ValidationRule

继承

Object

ValidationRule

ExceptionValidationRule

示例

属性 ValidationRules 采用 对象的集合 ValidationRule 。 以下示例使用 TextBox.Text 作为绑定目标属性， (StartPrice 整数) 作为绑定源属性。 当用户输入无法转换为整数的值时，将引发异常，导致 ExceptionValidationRule 使目标值失效。

<TextBox Name="StartPriceEntryForm" Grid.Row="2" Grid.Column="1"
    Style="{StaticResource textStyleTextBox}" Margin="8,5,0,5">
  <TextBox.Text>
    <Binding Path="StartPrice" UpdateSourceTrigger="PropertyChanged">
      <Binding.ValidationRules>
        <ExceptionValidationRule />
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>

默认情况下，当出现验证错误时， TextBox 将显示带有红色边框的 。 （可选）可以编写自定义 ErrorTemplate ，以指定在出现验证错误时通知用户的方式。

有关数据验证的详细信息，请参阅 数据绑定概述。

有关完整示例，请参阅 数据绑定演示。

注解

WPF 数据绑定模型使你能够与 Binding 对象关联ValidationRules。 类 ExceptionValidationRule 是一个内置规则，用于检查在更新绑定源属性期间引发的异常。 可以提供自定义逻辑来指定绑定引擎如何使用 UpdateSourceExceptionFilterCallback处理这些异常。 有关详细信息，请参阅 UpdateSourceExceptionFilter。

用于显式设置 ExceptionValidationRule 的替代语法是在 Binding 或 MultiBinding 对象上将 ValidatesOnExceptions 属性设置为 true。

可以通过创建派生自 ValidationRule的类来创建自定义规则。 有关数据验证的详细信息和详细讨论，请参阅 数据绑定概述。

构造函数

ExceptionValidationRule()

初始化 ExceptionValidationRule 类的新实例。

属性

ValidatesOnTargetUpdated	获取或设置一个值，该值指示当 Binding 的目标更新时是否运行验证规则。 (继承自 ValidationRule)
ValidationStep	获取或设置验证规则的运行时间。 (继承自 ValidationRule)

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
Validate(Object, CultureInfo)	对值执行验证检查。
Validate(Object, CultureInfo, BindingExpressionBase)	对值执行验证检查。 (继承自 ValidationRule)
Validate(Object, CultureInfo, BindingGroup)	对值执行验证检查。 (继承自 ValidationRule)

另请参阅

• ValidationRule
• DataErrorValidationRule