TypeValidationEventArgs.Cancel 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

TypeValidationEventArgs.cs

取得或設定一個值，指示事件是否應被取消。

public:
 property bool Cancel { bool get(); void set(bool value); };

public bool Cancel { get; set; }

member this.Cancel : bool with get, set

Public Property Cancel As Boolean

屬性值

Boolean

true 若事件應被取消並控制組保留 MaskedTextBox 焦點;否則， false 繼續驗證處理。

範例

以下程式碼範例展示了此成員的使用方式。 在這個例子中，事件處理者會回報事件 MaskedTextBox.TypeValidationCompleted 的發生情況。 此報告能幫助您了解事件發生時間，並協助除錯。 若要報告多個事件或頻繁發生的事件，請考慮將MessageBox.Show訊息替換Console.WriteLine為或附加於多行TextBox。

要執行範例程式碼，請將其貼到包含一個 MaskedTextBox 名為 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事件發生在事件發生Validating之前。

在事件處理程序中將屬性設Cancel為 會true取消該事件，導致MaskedTextBox控制項保留焦點，除非後續Validating事件將其屬性CancelEventArgs.Cancel版本設為 false。TypeValidationCompleted

另請參閱

• TypeValidationCompleted
• Validating