TypeValidationEventArgs 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

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 发生该事件。 仅当属性不是null并且发生因果操作（例如MaskedTextBox控件失去焦点）时MaskedTextBox.ValidatingType，才会进行类型验证。 类型验证 可将格式化的输入字符串转换为属性所表示 ValidatingType 的类型。 有关类型验证过程的详细信息，请参阅该 TypeValidationCompleted 事件。

如果为 TypeValidationCompleted某个事件处理程序实现，处理程序将接收一个类型 TypeValidationEventArgs参数。 此参数包含有关事件的信息，例如类型转换过程是否成功、验证类型等。

构造函数

名称	说明
TypeValidationEventArgs(Type, Boolean, Object, String)	初始化 TypeValidationEventArgs 类的新实例。

属性

名称	说明
Cancel	获取或设置一个值，该值指示是否应取消事件。
IsValidInput	获取一个值，该值指示格式化的输入字符串是否已成功转换为验证类型。
Message	获取描述转换过程的文本消息。
ReturnValue	获取从格式化输入字符串转换结果的对象。
ValidatingType	获取要对其验证格式化输入字符串的类型。

另请参阅

• ValidatingType
• ValidateText()
• TypeValidationCompleted
• 演练：使用 MaskedTextBox 控件