如何验证用户输入（Windows 窗体 .NET）概述

项目
10/13/2023

用户在应用程序中输入数据后，建议在应用程序使用数据之前验证数据是否有效。可以要求某些文本字段的长度不能为零，字段应设置为电话号码格式，或者字符串中不得包含无效字符。 Windows 窗体提供了多种方式来验证应用程序中的输入。

重要

面向 .NET 7 和 .NET 6 的桌面指南文档正在撰写中。

MaskedTextBox 控件

如果需要用户以明确定义的格式输入数据，例如电话号码或零件编号，则可以使用 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。有关正则表达式的详细信息，请参阅 .NET 正则表达式和正则表达式示例。
如果邮政编码必须是有效的美国邮政编码，则可以调用邮政编码 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 属性可完全防止隐式验证。若要验证控件，必须使用显式验证。

显式验证

显式验证方法可同时验证数据。可以验证数据，以响应用户操作，例如单击“保存”按钮或“下一步”链接。发生用户操作时，可以通过以下方式之一触发显式验证：

调用 Validate 以验证最后一个控件是否失去焦点。
调用 ValidateChildren 以验证窗体或容器控件中的所有子级控件。
调用自定义方法，以手动验证控件中的数据。

控件的默认隐式验证行为

不同的 Windows 窗体控件的 AutoValidate 属性具有不同的默认值。下表显示了最常见的控件及其默认值。

控制	默认验证行为
ContainerControl	Inherit
Form	EnableAllowFocusChange
PropertyGrid	Visual Studio 中未公开的属性
ToolStripContainer	Visual Studio 中未公开的属性
SplitContainer	Inherit
UserControl	EnableAllowFocusChange

关闭窗体和重写验证

控件保持焦点时，由于其所包含的数据无效，因此无法通过以下常用方法之一关闭父级窗体：

单击“关闭”按钮。
选择“系统”>“关闭”菜单。
以编程方式调用 Close 方法。

但在某些情况下，无论控件中的值是否有效，均建议让用户关闭窗体。可以通过为窗体的 FormClosing 事件创建处理程序来重写验证并关闭仍包含无效数据的窗体。在事件中，将 Cancel 属性设置为 false。这将强制关闭窗体。有关详细信息及示例，请参阅Form.FormClosing。

注意

如果以这种方式强制关闭窗体，则会丢失窗体控件中尚未保存的所有数据。此外，模式窗体在关闭时不会验证控件的内容。你仍可以使用控件验证将焦点锁定在控件上，但不必担心与关闭窗体相关的行为。

Share via