TypeValidationEventArgs.Cancel Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah acara harus dibatalkan.
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
Nilai Properti
true
jika acara harus dibatalkan dan fokus dipertahankan oleh MaskedTextBox kontrol; jika tidak, false
untuk melanjutkan pemrosesan validasi.
Contoh
Contoh kode berikut menunjukkan penggunaan anggota ini. Dalam contoh, penanganan aktivitas melaporkan kemunculan MaskedTextBox.TypeValidationCompleted peristiwa. Laporan ini membantu Anda mempelajari kapan peristiwa terjadi dan dapat membantu Anda dalam penelusuran kesalahan. Untuk melaporkan beberapa peristiwa atau peristiwa yang sering terjadi, pertimbangkan untuk mengganti MessageBox.Show dengan Console.WriteLine atau menambahkan pesan ke multibaris TextBox.
Untuk menjalankan kode contoh, tempelkan ke dalam proyek yang berisi instans jenis MaskedTextBox bernama MaskedTextBox1
. Kemudian pastikan bahwa penanganan aktivitas dikaitkan dengan peristiwa.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
Keterangan
Peristiwa terjadi TypeValidationCompleted tepat sebelum Validating peristiwa.
Cancel Mengatur properti ke true
di TypeValidationCompleted penanganan aktivitas akan membatalkan acara, menyebabkan MaskedTextBox kontrol mempertahankan fokus, kecuali peristiwa berikutnya Validating mengatur versi CancelEventArgs.Cancel propertinya ke false
.