如何:实现绑定验证

此示例演示如何基于自定义的验证规则,使用 ErrorTemplate 和样式触发器来提供可视反馈,以便在输入无效值时向用户发出通知。

示例

下面示例中的 TextBox 的文本内容绑定到名为 ods 的绑定源对象的 Age 属性(类型为 int)。 该绑定设置用于使用名为 AgeRangeRule 的验证规则,以便当用户输入了非数值字符或输入的值小于 21 或者大于 130 时,文本框旁边将显示一个红色感叹号,并且当用户将鼠标移动到该文本框上时,将显示包含错误消息的工具提示。

<TextBox Name="textBox1" Width="50" FontSize="15"
         Validation.ErrorTemplate="{StaticResource validationTemplate}"
         Style="{StaticResource textBoxInError}"
         Grid.Row="1" Grid.Column="1" Margin="2">
  <TextBox.Text>
    <Binding Path="Age" Source="{StaticResource ods}"
             UpdateSourceTrigger="PropertyChanged" >
      <Binding.ValidationRules>
        <c:AgeRangeRule Min="21" Max="130"/>
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>

下面的示例演示了 AgeRangeRule 的实现,该实现从 ValidationRule 继承并重写 Validate 方法。 对值调用 Int32.Parse() 方法,以确保该值不包含任何无效字符。 Validate 方法返回 ValidationResult,该结果基于分析期间是否引发了异常以及生存期值是否超出了上界和下界,来指示该值是否有效。

public class AgeRangeRule : ValidationRule
{
    private int _min;
    private int _max;

    public AgeRangeRule()
    {
    }

    public int Min
    {
        get { return _min; }
        set { _min = value; }
    }

    public int Max
    {
        get { return _max; }
        set { _max = value; }
    }

    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
    {
        int age = 0;

        try
        {
            if (((string)value).Length > 0)
                age = Int32.Parse((String)value);
        }
        catch (Exception e)
        {
            return new ValidationResult(false, "Illegal characters or " + e.Message);
        }

        if ((age < Min) || (age > Max))
        {
            return new ValidationResult(false,
              "Please enter an age in the range: " + Min + " - " + Max + ".");
        }
        else
        {
            return new ValidationResult(true, null);
        }
    }
}

下面的示例演示了自定义的 ControlTemplate validationTemplate,它用于创建一个红色感叹号,以通知用户验证错误。 控件模板用于重新定义控件的外观。

<ControlTemplate x:Key="validationTemplate">
  <DockPanel>
    <TextBlock Foreground="Red" FontSize="20">!</TextBlock>
    <AdornedElementPlaceholder/>
  </DockPanel>
</ControlTemplate>

如下面的示例中所示,显示错误消息的 ToolTip 是使用名为 textBoxInError 的样式创建的。 如果 HasError 的值是 true,则触发器将当前 TextBox 的工具提示设置为其第一个验证错误。 RelativeSource 设置为 Self,以引用当前元素。

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)[0].ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

有关完整示例,请参见 Binding Validation Sample(绑定验证示例)。

请注意,如果未提供自定义的 ErrorTemplate,则当出现验证错误时,将显示默认错误模板来为用户提供可视反馈。 有关更多信息,请参见数据绑定概述中的“数据验证”。 另外,WPF 还提供了内置验证规则,该规则捕获在更新绑定源属性期间引发的异常。 有关更多信息,请参见 ExceptionValidationRule

请参见

概念

数据绑定概述

其他资源

数据绑定帮助主题