TypeValidationEventArgs 類別

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

提供 TypeValidationCompleted 事件的資料。

public ref class TypeValidationEventArgs : EventArgs

public class TypeValidationEventArgs : EventArgs

type TypeValidationEventArgs = class
    inherit EventArgs

Public Class TypeValidationEventArgs
Inherits EventArgs

繼承

Object

EventArgs

TypeValidationEventArgs

範例

下列程式碼範例示範此類型的用法。 在此範例中，事件處理常式會報告事件的發生次數 TypeValidationCompleted 。 此報告可協助您瞭解事件發生的時間，並可協助您進行偵錯。 若要報告多個事件或經常發生的事件，請考慮將 取代 Show 為 Console.WriteLine 或將訊息附加至多行 TextBox 。

若要執行範例程式碼，請將它貼入包含名為 MaskedTextBox1 之類型 MaskedTextBox 實例的專案。 然後，確定事件處理常式與 事件相關聯 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.ValidatingType ，才會發生類型驗證，例如 MaskedTextBox 控制項失去焦點。 類型驗證 可將格式化的輸入字串轉換為 屬性所代表的類型 ValidatingType 。 如需類型驗證程式的詳細資訊，請參閱 TypeValidationCompleted 事件。

如果 針對 實作 TypeValidationCompleted 事件處理常式，處理常式會接收 類型 TypeValidationEventArgs 為 的參數。 此參數包含事件的相關資訊，例如類型轉換程式是否成功、驗證類型等等。

建構函式

TypeValidationEventArgs(Type, Boolean, Object, String)

初始化 TypeValidationEventArgs 類別的新執行個體。

屬性

Cancel	取得或設定值，這個值表示是否應該取消事件。
IsValidInput	取得值，指出格式化輸入字串是否成功轉換成驗證的型別。
Message	取得描述轉換處理序的文字訊息。
ReturnValue	取得格式化輸入字串之轉換所產生的物件。
ValidatingType	取得型別，以便做為驗證格式化輸入字串的依據。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• ValidatingType
• ValidateText()
• TypeValidationCompleted
• 逐步解說：使用 MaskedTextBox 控制項