WPF快速指导5:验证
本文摘要:
1:WPF中的验证处理机制;
2:自定义验证规则;
3:如何显示验证错误信息
4:指定何时进行验证
1:WPF中的验证处理机制
接受用户输入的大多数应用程序都需要具有验证逻辑,以确保用户输入了需要的信息。验证检查可以基于类型、范围、格式或其他应用程序特定的要求。本节讨论了数据验证在 WPF 中的工作方式。
先来看一个简单的例子
<Window.Resources>
<local:Person x:Key="luminji" Name="luminji" Age="3"></local:Person>
</Window.Resources>
<StackPanel DataContext="{StaticResource luminji}" >
<TextBox x:Name="textBoxAge">
<TextBox.Text>
<Binding Path="Age" NotifyOnValidationError="True">
<Binding.ValidationRules>
<ExceptionValidationRule></ExceptionValidationRule>
</Binding.ValidationRules>
</Binding>
</TextBox.Text>
</TextBox>
<Button>Button</Button>
</StackPanel>
后台:
public partial class Window1 : Window
{
public Window1()
{
InitializeComponent();
Validation.AddErrorHandler(this.textBoxAge, delegate(object sender, ValidationErrorEventArgs e)
{
MessageBox.Show(e.Error.ErrorContent.ToString());
});
}
}
class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
WPF中的验证处理机制是:当验证结果出现非法数据时,就会产生一个包含错误信息的ValidationError对象供界面进行显示。在使用了ExceptionValidationRule的情况下,这个错误对象会包含验证规则所捕获到的Exception对象的Message属性。当然,为了,访问到这个异常,我们需要为页面的Validation对象添加附件事件,即上文中Validation.AddErrorHandler(……)。注意,为了能捕获这个事件,还需要将数据绑定中的NotifyOnValidationError设置为True。
把这段代码运行起来,如果你在文本框中输入的不是数字,则会弹出ExceptionValidationRule中默认的“输入字符串的格式不正确”。但是显然,这种系统默认提供给我们的提示信息不能满足我们的要求。如果要对错误进行更多的自定义处理,首先就要自定义验证规则。
2:自定义验证规则
自定义验证规则需要继承抽象类ValidationRule,并重写Validate方法。然后在XAML中的ExceptionValidationRule换成自定义的验证规则类就行。
前台中相应替换的内容:
<TextBox.Text>
<Binding Path="Age" NotifyOnValidationError="True">
<Binding.ValidationRules>
<local:AgeRule></local:AgeRule>
</Binding.ValidationRules>
</Binding>
</TextBox.Text>
后台的自定义验证类:
class AgeRule: ValidationRule
{
public override ValidationResult Validate(object value, System.Globalization.CultureInfo cultureInfo)
{
int number;
if (!int.TryParse((string)value, out number))
{
return new ValidationResult(false, "输入的内容必须为数字!");
}
else if( number > 100 || number < 0)
{
return new ValidationResult(false, "输入的年龄超过范围");
}
else
{
//return new ValidationResult(true, null);
return ValidationResult.ValidResult;
}
}
}
我们注意到,上文中的100和0是硬编码,还有一种虽然是前台硬编码,但是看上去要舒服很多,见下文:
前台中相应替换的内容:
<TextBox.Text>
<Binding Path="Age" NotifyOnValidationError="True">
<Binding.ValidationRules>
<local:AgeRule Max="100" Min="0"></local:AgeRule>
</Binding.ValidationRules>
</Binding>
</TextBox.Text>
后台中相应变化的内容:
class AgeRule: ValidationRule
{
public int Min { get; set; }
public int Max { get; set; }
public override ValidationResult Validate(object value, System.Globalization.CultureInfo cultureInfo)
{
int number;
if (!int.TryParse((string)value, out number))
{
return new ValidationResult(false, "输入的内容必须为数字!");
}
else if( number > Max || number < Min)
{
return new ValidationResult(false, "输入的年龄超过范围");
}
else
{
//return new ValidationResult(true, null);
return ValidationResult.ValidResult;
}
}
}
3:如何显示验证错误信息
在上文中,我们通过MessageBox来显示验证的错误信息。看上去有点业余,即用户友好度不够,更好的处理方法是在UI上指定一个固定的区域进行显示。指定固定区域进行显示有三种方法。
第一种,是在Validation.AddErrorHandler为某个区域赋值错误信息。如下文代码中的textBlockErrorMessage0。
第二种,是为区域绑定错误信息,如下文代码中的textBlockErrorMessage1。
第三种,是为Validation.HasError设定触发器,指定Validation.ErrorTemplate来动态显示错误信息。
提倡第三种做法。
前台代码:
<Window.Resources>
<local:Person x:Key="luminji" Name="luminji" Age="3"></local:Person>
<Style TargetType="{x:Type TextBox}">
<Style.Triggers>
<Trigger Property="Validation.HasError" Value="true">
<Setter Property="Validation.ErrorTemplate">
<Setter.Value>
<ControlTemplate>
<DockPanel LastChildFill="True">
<TextBlock DockPanel.Dock="Right" Text="{Binding ElementName=MyAdorner, Path=AdornedElement.(Validation.Errors)[0].ErrorContent}">
</TextBlock>
<Border BorderBrush="Red" BorderThickness="1">
<AdornedElementPlaceholder Name="MyAdorner"/>
</Border>
</DockPanel>
</ControlTemplate>
</Setter.Value>
</Setter>
</Trigger>
</Style.Triggers>
</Style>
</Window.Resources>
<StackPanel DataContext="{StaticResource luminji}" >
<TextBox x:Name="textBoxAge" Width="100">
<TextBox.Text>
<Binding Path="Age" NotifyOnValidationError="True" UpdateSourceTrigger="PropertyChanged">
<Binding.ValidationRules>
<local:AgeRule Max="100" Min="0"></local:AgeRule>
</Binding.ValidationRules>
</Binding>
</TextBox.Text>
</TextBox>
<TextBlock x:Name="textBlockErrorMessage0"/>
<TextBlock x:Name="textBlockErrorMessage1" Text="{Binding ElementName=textBoxAge, Path=(Validation.Errors)[0].ErrorContent}" />
<Button>Button</Button>
</StackPanel>
后台代码代码因为和上文的后台代码没有太多区别,故略。
值得注意的是,前台代码的触发器中,<TextBlock DockPanel.Dock="Right" Text="{Binding ElementName=MyAdorner, Path=AdornedElement.(Validation.Errors)[0].ErrorContent}">,AdornedElement这个属性不能少。AdornedElement表示的是当前装饰器所在的UIElement。
4:指定何时进行验证
上文的例子中,我们都是在文本框失去焦点的时候看到验证的错误信息的。我们还可以指定这个验证的时机,就是为文本框的绑定设置UpdateSourceTrigger。如:<Binding Path="Age" NotifyOnValidationError="True" UpdateSourceTrigger="PropertyChanged">。就是指定每次输入字符就验证一次。

本文基于
Creative Commons Attribution 2.5 China Mainland License发布,欢迎转载,演绎或用于商业目的,但是必须保留本文的署名
http://www.cnblogs.com/luminji(包含链接)。如您有任何疑问或者授权方面的协商,请给我留言。