TypeValidationEventArgs.Cancel Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállít egy értéket, amely jelzi, hogy az eseményt le kell-e mondani.
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
Tulajdonság értéke
true ha az eseményt meg kell szakítani, és a vezérlő megtartja a MaskedTextBox fókuszt; false ellenkező esetben az érvényesítési feldolgozás folytatása.
Példák
Az alábbi példakód bemutatja ennek a tagnak a használatát. A példában egy eseménykezelő jelentést készít az MaskedTextBox.TypeValidationCompleted esemény előfordulásáról. Ez a jelentés segít megismerni az esemény bekövetkeztét, és segítséget nyújthat a hibakeresésben. Ha több eseményről vagy gyakran előforduló eseményről szeretne jelentést tenni, fontolja meg az üzenet többsorosra MessageBox.Showcserélését Console.WriteLineTextBox vagy hozzáfűzését.
A példakód futtatásához illessze be egy olyan projektbe, amely egy nevesített MaskedTextBoxpéldányt MaskedTextBox1 tartalmaz. Ezután győződjön meg arról, hogy az eseménykezelő az eseményhez MaskedTextBox.TypeValidationCompleted van társítva.
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
Megjegyzések
Az TypeValidationCompleted esemény az esemény előtt Validating következik be.
Ha a tulajdonságot Canceltrue az TypeValidationCompleted eseménykezelőben állítja be, az megszakítja az eseményt, így a vezérlő megtartja a MaskedTextBox fókuszt, hacsak az azt követő Validating esemény nem állítja be a tulajdonság CancelEventArgs.Cancelverzióját.false