TypeValidationEventArgs Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

TypeValidationEventArgs.cs

Предоставляет данные для события TypeValidationCompleted.

public ref class TypeValidationEventArgs : EventArgs

public class TypeValidationEventArgs : EventArgs

type TypeValidationEventArgs = class
    inherit EventArgs

Public Class TypeValidationEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

TypeValidationEventArgs

Примеры

В следующем примере кода демонстрируется использование этого типа. В этом примере обработчик событий сообщает о возникновении TypeValidationCompleted события. Этот отчет поможет вам узнать, когда происходит событие, и помочь вам в отладке. Чтобы сообщить о нескольких событиях или событиях, которые происходят часто, рекомендуется заменить ShowConsole.WriteLine или добавить сообщение в многостроочное TextBox.

Чтобы запустить пример кода, вставьте его в проект, содержащий экземпляр типа MaskedTextBox с именем MaskedTextBox1. Затем убедитесь, что обработчик событий связан с событием TypeValidationCompleted .

private void MaskedTextBox1_TypeValidationCompleted(Object sender, TypeValidationEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "IsValidInput", e.IsValidInput );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Message", e.Message );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ValidatingType", e.ValidatingType );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "TypeValidationCompleted Event" );
}

Private Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs) _ 
     Handles MaskedTextBox1.TypeValidationCompleted

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "IsValidInput", e.IsValidInput)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Message", e.Message)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ValidatingType", e.ValidatingType)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"TypeValidationCompleted Event")

End Sub

Комментарии

Событие TypeValidationCompleted возникает, когда MaskedTextBox элемент управления выполняет необязательную проверку типа. Проверка типа происходит только в том случае, если MaskedTextBox.ValidatingType свойство не null является и происходит причинное действие, например MaskedTextBox элемент управления теряет фокус. Проверка типа — это возможность преобразовать отформатированную входную строку в тип, представленный свойством ValidatingType . Дополнительные сведения о процессе проверки типов см. в событии TypeValidationCompleted .

Если обработчик событий реализован для TypeValidationCompleted, обработчик получает параметр типа TypeValidationEventArgs. Этот параметр содержит сведения о событии, например о том, успешно ли выполнен процесс преобразования типов, тип проверки и т. д.

Конструкторы

Имя	Описание
TypeValidationEventArgs(Type, Boolean, Object, String)	Инициализирует новый экземпляр класса TypeValidationEventArgs.

Свойства

Имя	Описание
Cancel	Возвращает или задает значение, указывающее, следует ли отменить событие.
IsValidInput	Возвращает значение, указывающее, была ли отформатированная входная строка успешно преобразована в проверяющий тип.
Message	Возвращает текстовое сообщение, описывающее процесс преобразования.
ReturnValue	Возвращает объект, который приводит к преобразованию форматируемой входной строки.
ValidatingType	Возвращает тип, на который проверяется отформатированная входная строка.

См. также раздел

• ValidatingType
• ValidateText()
• TypeValidationCompleted
• Пошаговое руководство. Работа с элементом управления MaskedTextBox