1. ErrorProvider概述 我们经常使用Windows Forms下的ErrorProvider,这是一个.NET组件,可以在VS IDE的工具栏中找到它。Errorprovider通常用于窗体或控件的用户输入;同时它也是典型的关联型(绑定)的验证控件,用以验证并显示控件关联的数据源如DataSet中存在的错误。ErrorProvider比使用消息框(MessageBox)显示错误信息的效果好,除了摘要中提到的情况外,还因为一旦消息框关闭了错误信息也随之消失,用户可能无法记忆所有的错误内容因而也就无法方便的纠正所有错误从而要多次弹出错误消息框。而 ErrorProvider会记录所有的错误并能够准确定位在错误发生的窗体或控件上,显示一个红色图标,当鼠标悬停在该图标上方时还能够自动弹出ToolTip提示以显示错误内容。这样操作人员可以根据错误发生的位置以及具体内容从容的修改错误,直到这些小图标全部消失。 2. ErrorProvider属性 ErrorProvider组件有三个关键的属性:DataSource、ContainerControl和Icon。
3. ErrorProvider常规用法 ErrorProvider的一种最简单使用方法就是当用户向某控件比如TextBox中输入无效数据时显示错误提示,这种情况下甚至不需要设置 DataSource,只需要设置ContainerControl属性值为当前Form并使用SetError方法进行简单编码即可,如下所示。 protected void textBox1_Validating (object sender, System.ComponentModel.CancelEventArgs e) { try { int x = Int32.Parse(textBox1.Text); errorProvider1.SetError(textBox1, ""); } catch (Exception e) errorProvider1.SetError(textBox1, "Not an integer value."); } 在窗体上一个TextBox控件的验证事件处理方法中我们检查用户填入内容是否是数值,如果不是则在该TextBox控件旁显示错误图标,相应的 ToolTip文本就是“Not an integer value”。从另外一个角度,我们也可以猜到如果要手工消除错误信息,也是通过SetError方法将提示文本设为空字符串即可。 实际上,ErrorProvider组件也可以捕获到DataSet或其他数据源的列上出现的错误,也就是说一旦将ErrorProvider绑定到数据源,不必直接关联到控件就可以在绑定相同数据源的控件上显示错误图标,代码如下。
textBox1.DataBindings.Add("Text", DataSet1, "Customers.Name"); errorProvider1.DataSource = DataSet1; errorProvider1.DataMember = "Customers";
DataTable1.Rows[5].SetColumnError("Name", "Bad data in this row.");//Name是列名,后面是错误提示 this.BindingContext [DataTable1].Position = 5;//发生错误的行是Table的第五行,ErrorProvider绑定这一行 4. ErrorProvider的实体绑定机制 上面列举的ErrorProvider的用法都是最基本的,不用编码或者只需少量编码或者设置一些相关的属性就能够实现一定的功能,然而这些实现方式对于一个相当规模的系统而言扩展性非常有限,不够灵活,而且没有与系统框架紧密结合起来。事实上,大多数情况下我们的系统具有严格的分层,其中不乏有O/RMapping。当在前台界面上作数据保存、更新时往往会涉及到对底层实体的操作。实体装载的数据是否满足业务规则,是否满足数据库定义的要求应当能够反映在前台的界面上。这样一个从上层(UI层)提交数据给下层(业务层、实体层)到从下层反馈错误信息给上层的过程也可以利用 ErrorProvider提供的便利。我们完全可以构建一套完整的数据绑定机制,当实体层发生数据错误时在界面上的ErrorProvider可以及时感知到并显示出来。这也就是所谓的智能感知,当然除了ErrorProvider还需要bindingsource组件的支持。如下图所示。 在系统界面上我们可以看到接受用户输入信息的控件都有一个DataBindings属性目录,其中又包含三个具体的控件属性项分别是Advanced、Tag、Text,如下图所示。 点击"高级"(Advanced)项,弹出一个数据绑定对话框,右边的条目分别用以设置该控件绑定数据源的字段,数据源发生更新的模式以及该控件录入信息必须满足的格式类型,如下图所示。 对于智能感知而言,数据源更新模式项非常重要,Never条目表明不提示数据源更新;OnPropertyChanged表明当数据源属性发生改变时提示数据源更新,用户可以看到窗体界面的左上角窗体标题的后面多出一个"*"号,操作保存或放弃后该星号消失; OnValidation表明当数据验证时提示数据源更新。(关于智能感知的部分不是本文介绍的重点,请参见MSDN相关文档。)同样对于错误提示而言也有两种情况,一种是当用户在界面控件上输入不符合规则的数据后立刻提示错误,另一种是用户点击保存或更新按钮动作后再进行数据验证并在界面上显示错误信息,两种方式都是通过ErrorProvider实现的,这里重点讨论第二种方式。 为了让ErrorProvider能够感知到数据源内部发生的错误,数据实体应至少继承两个接口 INotifyPropertyChanged和IDataErrorInfo。这两个接口都位于System.ComponentModel命名空间下,前者提供了一个属性改变事件PropertyChanged,继承的实体内每个简单属性都应该引发该事件以便外部捕获到属性值的改变;后者提供了一个错误信息列表Error用以自定义错误信息,也就是ToolTip要显示的内容,还有一个索引器用以根据列名获取对应的错误信息。通常情况下,我们都会为所有的实体定义一个基类,该基类继承上述接口,实现相应的属性,另外为方便起见还会新增一个IsValid属性以表明派生的实体类当前属性是否通过验证。 需要注意的是,这里关于Error属性的设置也存在两种方式,一种是在实体内部定义业务验证规则,将每个属性必须满足的规则定义好以及将发生错误时生成的错误信息定义好以便填充到Error属性中。但是这种方法存在一个很严重的缺陷就是业务规则与实体实现紧耦合不方便移植和扩展。另一种办法就是在实体基类中定义一个公共方法专门用以为每个属性设置错误信息,这样我们就可以在业务层进行数据校验时将对应错误信息写入到该实体的错误列表中。 |