TypeValidationEventArgs Класс

Определение

Предоставляет данные для события TypeValidationCompleted.Provides data for the TypeValidationCompleted event.

public ref class TypeValidationEventArgs : EventArgs
public class TypeValidationEventArgs : EventArgs
type TypeValidationEventArgs = class
    inherit EventArgs
Public Class TypeValidationEventArgs
Inherits EventArgs
Наследование
TypeValidationEventArgs

Примеры

В следующем примере кода демонстрируется использование этого типа.The following code example demonstrates the use of this type. В этом примере обработчик событий сообщает о возникновении TypeValidationCompleted события.In the example, an event handler reports on the occurrence of the TypeValidationCompleted event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке.This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены Show Console.WriteLine или добавления сообщения в многострочный TextBox .To report on multiple events or on events that occur frequently, consider replacing Show with Console.WriteLine or appending the message to a multiline TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа MaskedTextBox с именем MaskedTextBox1 .To run the example code, paste it into a project that contains an instance of type MaskedTextBox named MaskedTextBox1. Затем убедитесь, что обработчик событий связан с TypeValidationCompleted событием.Then ensure that the event handler is associated with the TypeValidationCompleted event.

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 элемент управления выполняет необязательную проверку типа.The TypeValidationCompleted event occurs when a MaskedTextBox control performs optional type validation. Проверка типа выполняется только в том случае, если MaskedTextBox.ValidatingType свойство не имеет значение null и происходит действие, равное, например, если MaskedTextBox элемент управления теряет фокус.Type validation occurs only when the MaskedTextBox.ValidatingType property is not null and a causal action occurs, such as the MaskedTextBox control losing focus. Проверка типа — это возможность преобразования форматированной входной строки в тип, представленный ValidatingType свойством.Type validation is the ability to convert the formatted input string to the type represented by the ValidatingType property. Дополнительные сведения о процессе проверки типа см. в описании TypeValidationCompleted события.For more information about the type validation process, see the TypeValidationCompleted event.

Если обработчик событий реализован для TypeValidationCompleted , обработчик получает параметр типа TypeValidationEventArgs .If an event handler is implemented for TypeValidationCompleted, the handler receives a parameter of type TypeValidationEventArgs. Этот параметр содержит сведения о событии, например о том, завершился ли процесс преобразования типа, проверить тип и т. д.This parameter contains information about the event, such as whether the type conversion process succeeded, the validating type, and so on.

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

TypeValidationEventArgs(Type, Boolean, Object, String)

Инициализирует новый экземпляр класса TypeValidationEventArgs.Initializes a new instance of the TypeValidationEventArgs class.

Свойства

Cancel

Возвращает или задает значение, показывающее, следует ли отменить событие.Gets or sets a value indicating whether the event should be canceled.

IsValidInput

Получает значение, указывающее, было ли успешно выполнено преобразование входной строки в проверяющий тип.Gets a value indicating whether the formatted input string was successfully converted to the validating type.

Message

Получает текстовое сообщение, описывающее процесс преобразования.Gets a text message describing the conversion process.

ReturnValue

Получает объект, являющийся результатом преобразования отформатированной входной строки.Gets the object that results from the conversion of the formatted input string.

ValidatingType

Получает тип, по которому проверяется отформатированная входная строка.Gets the type that the formatted input string is being validated against.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

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