Проверка введенных пользователем данных в Windows Forms User Input Validation in Windows Forms

Когда пользователи вводят данные в приложение, может потребоваться проверить, являются ли данные допустимыми, прежде чем использовать их в приложении. When users enter data into your application, you may want to verify that the data is valid before your application uses it. Может потребоваться, чтобы определенные текстовые поля не были нулевой длины, поле было отформатировано как номер телефона или другой тип данных правильного формата или что строка не содержит небезопасный символ, который можно использовать для нарушения безопасности базы данных. You may require that certain text fields not be zero-length, that a field be formatted as a telephone number or other type of well-formed data, or that a string not contain any unsafe characters that could be used to compromise the security of a database. Windows Forms предоставляет несколько способов проверки входных данных в приложении. Windows Forms provides several ways for you to validate input in your application.

Проверка с помощью элемента управления MaskedTextBox Validation with the MaskedTextBox Control

Если требуется, чтобы пользователи вводили данные в четко определенном формате, например номер телефона или номер части, это можно сделать быстро и с минимальным кодом с помощью MaskedTextBox элемента управления. If you need to require users to enter data in a well-defined format, such as a telephone number or a part number, you can accomplish this quickly and with minimal code by using the MaskedTextBox control. Маска — это строка, состоящие из символов от языка маскирования, который указывает, какие символы могут быть введены в любом заданной позиции в текстовом поле. A mask is a string made up of characters from a masking language that specifies which characters can be entered at any given position in the text box. Элемент управления отображает набор запросов пользователю. The control displays a set of prompts to the user. Если пользователь вводит неправильную запись, например, пользователь вводит букву, когда требуется цифра, элемент управления автоматически отклоняет входные данные. If the user types an incorrect entry, for example, the user types a letter when a digit is required, the control will automatically reject the input.

Язык маскировки, используемый, MaskedTextBox является очень гибким. The masking language that is used by MaskedTextBox is very flexible. Он позволяет указать необходимые символы, необязательные символы, литеральные символы, такие как дефисы и круглые скобки, символы валют и разделители дат. It allows you to specify required characters, optional characters, literal characters, such as hyphens and parentheses, currency characters, and date separators. Элемент управления также хорошо работает при привязке к источнику данных. The control also works well when bound to a data source. FormatСобытие в привязке данных может использоваться для переформатирования входящих данных, чтобы соответствовать маске, а Parse событие может использоваться для переформатирования исходящих данных в соответствии со спецификациями поля данных. The Format event on a data binding can be used to reformat incoming data to comply with the mask, and the Parse event can be used to reformat outgoing data to comply with the specifications of the data field.

Дополнительные сведения см. в разделе элемент управления MaskedTextBox. For more information, see MaskedTextBox Control.

Проверка Event-Driven Event-Driven Validation

Если требуется полностью программный контроль над проверкой или необходимо выполнить сложные проверки, следует использовать события проверки, встроенные в большинство элементов управления Windows Forms. If you want full programmatic control over validation, or need to perform complex validation checks, you should use the validation events built into most Windows Forms controls. Каждый элемент управления, принимающий пользовательский ввод в свободной форме Validating , имеет событие, которое возникает каждый раз, когда элементу управления требуется проверка данных. Each control that accepts free-form user input has a Validating event that will occur whenever the control requires data validation. В Validating методе обработки событий можно проверить ввод пользователя несколькими способами. In the Validating event-handling method, you can validate user input in several ways. Например, если имеется текстовое поле, которое должно содержать почтовый индекс, можно выполнить проверку следующими способами. For example, if you have a text box that must contain a postal code, you can perform the validation in the following ways:

Если почтовый индекс должен принадлежать к определенной группе почтовых индексов, можно выполнить сравнение строк на входе для проверки данных, вводимых пользователем. If the postal code must belong to a specific group of zip codes, you can perform a string comparison on the input to validate the data entered by the user. Например, если почтовый индекс должен находиться в наборе <10001, 10002, 10003>, то для проверки данных можно использовать сравнение строк. For example, if the postal code must be in the set <10001, 10002, 10003>, then you can use a string comparison to validate the data.

Если почтовый индекс должен быть указан в определенной форме, можно использовать регулярные выражения для проверки данных, вводимых пользователем. If the postal code must be in a specific form you can use regular expressions to validate the data entered by the user. Например, для проверки формы ##### или #####-#### можно использовать регулярное выражение ^(\d<5>)(-\d<4>)?$ . For example, to validate the form ##### or #####-#### , you can use the regular expression ^(\d<5>)(-\d<4>)?$ . Чтобы проверить форму A#A #A# , можно использовать регулярное выражение [A-Z]\d[A-Z] \d[A-Z]\d . To validate the form A#A #A# , you can use the regular expression [A-Z]\d[A-Z] \d[A-Z]\d . Дополнительные сведения о регулярных выражениях см. в разделе .NET Framework регулярные выражения и примеры регулярных выражений. For more information about regular expressions, see .NET Framework Regular Expressions and Regular Expression Examples.

Если почтовый индекс должен быть допустимым США почтовым индексом, можно вызвать веб-службу почтового кода, чтобы проверить данные, введенные пользователем. If the postal code must be a valid United States Zip code, you could call a Zip code Web service to validate the data entered by the user.

ValidatingСобытием предоставляется объект типа CancelEventArgs . The Validating event is supplied an object of type CancelEventArgs. Если вы определили, что данные элемента управления недопустимы, можно отменить Validating событие, задав свойству этого объекта значение Cancel true . If you determine that the control’s data is not valid, you can cancel the Validating event by setting this object’s Cancel property to true . Если свойство не задано Cancel , Windows Forms предполагает, что проверка для этого элемента управления прошла удачно, и вызывает Validated событие. If you do not set the Cancel property, Windows Forms will assume that validation succeeded for that control, and raise the Validated event.

Пример кода, который проверяет адрес электронной почты в TextBox , см. в разделе Validating . For a code example that validates an email address in a TextBox, see Validating.

Привязка данных и проверка Event-Driven Data Binding and Event-Driven Validation

Проверка очень полезна, если элементы управления привязаны к источнику данных, например к таблице базы данных. Validation is very useful when you have bound your controls to a data source, such as a database table. С помощью проверки можно убедиться, что данные элемента управления соответствуют формату, требуемому для источника данных, и не содержат специальные символы, такие как кавычки и обратные косые черты, которые могут быть ненадежными. By using validation, you can make sure that your control’s data satisfies the format required by the data source, and that it does not contain any special characters such as quotation marks and back slashes that might be unsafe.

При использовании привязки данных данные в элементе управления синхронизируются с источником данных во время выполнения Validating события. When you use data binding, the data in your control is synchronized with the data source during execution of the Validating event. Если отменить Validating событие, данные не будут синхронизированы с источником данных. If you cancel the Validating event, the data will not be synchronized with the data source.

Если пользовательская проверка выполняется после Validating события, это не повлияет на привязку данных. If you have custom validation that takes place after the Validating event, it will not affect the data binding. Например, если имеется код в Validated событии, которое пытается отменить привязку данных, привязка данных все равно будет выполняться. For example, if you have code in a Validated event that attempts to cancel the data binding, the data binding will still occur. В этом случае для выполнения проверки в Validated событии измените свойство режим обновления источника данных элемента управления (в разделе (DataBindings) \ (дополнительно)) с onvalid Valid на Never и добавьте элемент управления .DataBindings[» «].WriteValue() в код проверки. In this case, to perform validation in the Validated event, change the control’s Data Source Update Mode property (under (Databindings)\ (Advanced)) from OnValidation to Never, and add Control .DataBindings[» «].WriteValue() to your validation code.

Явная и явная проверка Implicit and Explicit Validation

Итак, когда выполняется проверка данных элемента управления? So when does a control’s data get validated? Это разработчик. This is up to you, the developer. В зависимости от потребностей приложения можно использовать явную или явную проверку. You can use either implicit or explicit validation, depending on the needs of your application.

Неявная проверка Implicit Validation

При неявном подходе проверки данные проверяются по мере его ввода пользователем. The implicit validation approach validates data as the user enters it. Данные можно проверить по мере ввода данных в элемент управления, прочитав клавиши по мере их нажатия или чаще, когда пользователь получит фокус ввода от одного элемента управления и перейдет к следующему. You can validate the data as the data is entered in a control by reading the keys as they are pressed, or more commonly whenever the user takes the input focus away from one control and moves to the next. Этот подход удобен, если вы хотите предоставить пользователю немедленный отзыв о данных по мере их работы. This approach is useful when you want to give the user immediate feedback about the data as they are working.

Если вы хотите использовать неявную проверку для элемента управления, необходимо задать свойству этого элемента управления значение AutoValidate EnablePreventFocusChange или EnableAllowFocusChange . If you want to use implicit validation for a control, you must set that control’s AutoValidate property to EnablePreventFocusChange or EnableAllowFocusChange. Если отменить Validating событие, поведение элемента управления будет определяться значением, которое вы присвоили AutoValidate . If you cancel the Validating event, the behavior of the control will be determined by what value that you assigned to AutoValidate. Если вы назначили EnablePreventFocusChange , отмена события приведет к возникновению этого Validated события. If you assigned EnablePreventFocusChange, canceling the event will cause the Validated event not to occur. Фокус ввода останется на текущем элементе управления до тех пор, пока пользователь не изменит данные на допустимый вход. Input focus will remain on the current control until the user changes the data to a valid input. Если вы назначили EnableAllowFocusChange , Validated событие не будет происходить при отмене события, но фокус по-прежнему изменится на следующий элемент управления. If you assigned EnableAllowFocusChange, the Validated event will not occur when you cancel the event, but focus will still change to the next control.

Присвоение Disable AutoValidate свойству предотвращает неявную проверку. Assigning Disable to the AutoValidate property prevents implicit validation altogether. Чтобы проверить элементы управления, необходимо будет использовать явную проверку. To validate your controls, you will have to use explicit validation.

Явная проверка Explicit Validation

При явном подходе проверки данные проверяются за один раз. The explicit validation approach validates data at one time. Можно проверить данные в ответ на действие пользователя, например нажав кнопку Сохранить или следующую ссылку. You can validate the data in response to a user action, such as clicking a Save button or a Next link. При возникновении действия пользователя можно активировать явную проверку одним из следующих способов: When the user action occurs, you can trigger explicit validation in one of the following ways:

Вызовите Validate , чтобы проверить последний элемент управления, чтобы он потерял фокус. Call Validate to validate the last control to have lost focus.

Вызовите метод ValidateChildren , чтобы проверить все дочерние элементы управления в форме или контейнере. Call ValidateChildren to validate all child controls in a form or container control.

Вызов пользовательского метода для проверки данных в элементах управления вручную. Call a custom method to validate the data in the controls manually.

Поведение неявной проверки по умолчанию для элементов управления Windows Forms Default Implicit Validation Behavior for Windows Forms Controls

Различные элементы управления Windows Forms имеют разные значения по умолчанию для своего AutoValidate Свойства. Different Windows Forms controls have different defaults for their AutoValidate property. В следующей таблице показаны наиболее распространенные элементы управления и их значения по умолчанию. The following table shows the most common controls and their defaults.

Control Control	Поведение проверки по умолчанию Default Validation Behavior
ContainerControl	Inherit
Form	EnableAllowFocusChange
PropertyGrid	Свойство не предоставлено в Visual Studio Property not exposed in Visual Studio
ToolStripContainer	Свойство не предоставлено в Visual Studio Property not exposed in Visual Studio
SplitContainer	Inherit
UserControl	EnableAllowFocusChange

Закрытие формы и Переопределение проверки Closing the Form and Overriding Validation

Когда элемент управления сохраняет фокус, поскольку содержащиеся в нем данные являются недопустимыми, невозможно закрыть родительскую форму одним из обычных способов: When a control maintains focus because the data it contains is invalid, it is impossible to close the parent form in one of the usual ways:

Нажав кнопку Закрыть . By clicking the Close button.

Выбрав пункт Закрыть в меню система . By selecting Close in the System menu.

Путем вызова Close метода программным способом. By calling the Close method programmatically.

Однако в некоторых случаях может потребоваться разрешить пользователю закрывать форму независимо от того, являются ли значения в элементах управления допустимыми. However, in some cases, you might want to let the user close the form regardless of whether the values in the controls are valid. Можно переопределить проверку и закрыть форму, которая по-прежнему содержит недопустимые данные, создав обработчик для FormClosing события формы. You can override validation and close a form that still contains invalid data by creating a handler for the form’s FormClosing event. В событии присвойте Cancel свойству значение false . In the event, set the Cancel property to false . Это приводит к закрытию формы. This forces the form to close. Дополнительные сведения и пример см. в разделе Form.FormClosing. For more information and an example, see Form.FormClosing.

Если принудительно закрыть форму таким образом, все данные в элементах управления формы, которые еще не были сохранены, теряются. If you force the form to close in this manner, any data in the form’s controls that has not already been saved is lost. Кроме того, модальные формы не проверяют содержимое элементов управления при их закрытии. In addition, modal forms do not validate the contents of controls when they are closed. Вы по-прежнему можете использовать проверку элемента управления для блокировки фокуса на элемент управления, но не нужно беспокоиться о поведении, связанном с закрытием формы. You can still use control validation to lock focus to a control, but you do not have to be concerned about the behavior associated with closing the form.