用户在应用程序中输入数据后,建议在应用程序使用数据之前验证数据是否有效。 可以要求某些文本字段的长度不能为零,字段应设置为电话号码格式,或者字符串中不得包含无效字符。 Windows 窗体提供了多种方式来验证应用程序中的输入。
如果需要用户以明确定义的格式输入数据,例如电话号码或零件编号,则可以使用?MaskedTextBox?控件以最少的代码快速实现此目的。 掩码是由掩码语言中的字符组成的字符串,用于指定可在文本框中的任何特定位置输入的字符。 控件向用户显示一组提示。 如果用户键入错误条目(例如,用户在需要输入数字时键入字母),则控件将自动拒绝输入。
MaskedTextBox?使用的掩码语言是灵活的。 它允许指定必填字符、可选字符、文本字符(例如连字符和括号)、货币字符和日期分隔符。 控件绑定到数据源时也可以正常工作。 可使用数据绑定上的?Format?事件重格式化输入数据,使其符合掩码;可使用?Parse?事件重格式化输出数据,使其符合数据字段的规范。
如果要获得对验证的完全编程控制,或者需要复杂的验证检查,则应使用大多数 Windows 窗体控件中内置的验证事件。 每个接受自由格式用户输入的控件都有?Validating?事件,并且控件需要数据验证时会发生该事件。 在?Validating?事件处理方法中,可以通过多种方式验证用户输入。 例如,如果文本框必须包含邮政编码,则可以通过以下方式进行验证:
如果邮政编码必须属于特定的邮政编码组,则可以对输入进行字符串比较,以验证用户输入的数据。 例如,如果邮政编码必须属于集合?{10001, 10002, 10003}
,则可以进行字符串比较来验证数据。
如果邮政编码必须采用特定格式,则可以使用正则表达式来验证用户输入的数据。 例如,若要验证格式?#####
?或?#####-####
,可以使用正则表达式?^(\d{5})(-\d{4})?$
。 若要验证格式?A#A #A#
,可以使用正则表达式?[A-Z]\d[A-Z] \d[A-Z]\d
。?
如果邮政编码必须是有效的美国邮政编码,则可以调用邮政编码 Web 服务来验证用户输入的数据。
Validating?事件由类型为?CancelEventArgs?的对象提供。 如果确定控件的数据无效,可将此对象的?Cancel?属性设置为?true
,以取消?Validating?事件。 如果未设置?Cancel?属性,则 Windows 窗体将假定针对该控件的验证成功,并引发?Validated?事件。
有关对?TextBox?中的电子邮件地址进行验证的代码示例,请参阅?Validating?事件参考。
将控件绑定到数据源(例如数据库表)时,验证很有用。 通过使用验证,可确保控件的数据符合数据源所需的格式,并可确保其不包含任何不安全的特殊字符,例如引号和反斜杠。
使用数据绑定时,控件中的数据会在?Validating?事件执行期间与数据源同步。 如果取消?Validating?事件,则数据不会与数据源同步。
?重要
如果在?Validating?事件之后进行自定义验证,不会影响数据绑定。 例如,如果使用?Validated?事件中的代码尝试取消数据绑定,仍将发生数据绑定。 在这种情况下,若要在?Validated?事件中执行验证,请将控件的?Binding.DataSourceUpdateMode?属性从?DataSourceUpdateMode.OnValidation?更改为?DataSourceUpdateMode.Never,然后将?your-control.DataBindings["field-name"].WriteValue()
?添加到验证代码。
何时验证控件的数据? 具体取决于开发人员。 可以根据应用程序的需要使用隐式或显式验证。
隐式验证方法在用户输入数据时对其进行验证。 通过在按键被按下时读取按键来验证数据,更常见的是,在用户将输入焦点从控件移开时验证数据。 如果希望在用户工作时为其提供有关数据的即时反馈,则此方法很有用。
如果要对控件使用隐式验证,则必须将该控件的?AutoValidate?属性设置为?EnablePreventFocusChange?或?EnableAllowFocusChange。 如果取消?Validating?事件,则控件的行为将由分配给?AutoValidate?的值决定。 如果分配了?EnablePreventFocusChange,则取消事件不会导致发生?Validated?事件。 输入焦点将保留在当前控件上,直到用户将数据更改为有效格式。 如果分配了?EnableAllowFocusChange,则取消事件时不会发生?Validated?事件,但焦点仍将更改为下一个控件。
将?Disable?分配给?AutoValidate?属性可完全防止隐式验证。 若要验证控件,必须使用显式验证。
显式验证方法可同时验证数据。 可以验证数据,以响应用户操作,例如单击“保存”按钮或“下一步”链接。 发生用户操作时,可以通过以下方式之一触发显式验证:
不同的 Windows 窗体控件的?AutoValidate?属性具有不同的默认值。 下表显示了最常见的控件及其默认值。
展开表
控制 | 默认验证行为 |
---|---|
ContainerControl | Inherit |
Form | EnableAllowFocusChange |
PropertyGrid | Visual Studio 中未公开的属性 |
ToolStripContainer | Visual Studio 中未公开的属性 |
SplitContainer | Inherit |
UserControl | EnableAllowFocusChange |
控件保持焦点时,由于其所包含的数据无效,因此无法通过以下常用方法之一关闭父级窗体:
但在某些情况下,无论控件中的值是否有效,均建议让用户关闭窗体。 可以通过为窗体的?FormClosing?事件创建处理程序来重写验证并关闭仍包含无效数据的窗体。 在事件中,将?Cancel?属性设置为?false
。?
?备注
如果以这种方式强制关闭窗体,则会丢失窗体控件中尚未保存的所有数据。 此外,模式窗体在关闭时不会验证控件的内容。 你仍可以使用控件验证将焦点锁定在控件上,但不必担心与关闭窗体相关的行为。