DataGridView.RowErrorTextNeeded Kejadian

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Terjadi saat teks kesalahan baris diperlukan.

public:
 event System::Windows::Forms::DataGridViewRowErrorTextNeededEventHandler ^ RowErrorTextNeeded;

public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded;

member this.RowErrorTextNeeded : System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler 

Public Custom Event RowErrorTextNeeded As DataGridViewRowErrorTextNeededEventHandler 

Jenis Acara

DataGridViewRowErrorTextNeededEventHandler

Contoh

Contoh kode berikut menunjukkan penggunaan anggota ini. Dalam contoh, penanganan aktivitas melaporkan kemunculan RowErrorTextNeeded 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 DataGridView bernama DataGridView1. Kemudian pastikan bahwa penanganan aktivitas dikaitkan dengan peristiwa.RowErrorTextNeeded

private void DataGridView1_RowErrorTextNeeded(Object sender, DataGridViewRowErrorTextNeededEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "RowErrorTextNeeded Event" );
}

Private Sub DataGridView1_RowErrorTextNeeded(sender as Object, e as DataGridViewRowErrorTextNeededEventArgs) _ 
     Handles DataGridView1.RowErrorTextNeeded

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"RowErrorTextNeeded Event")

End Sub

Keterangan

Peristiwa RowErrorTextNeeded hanya terjadi ketika DataSource properti DataGridView kontrol diatur atau propertinya VirtualMode adalah true. Menangani RowErrorTextNeeded peristiwa berguna ketika Anda ingin menentukan kesalahan untuk baris tergantung pada statusnya dan nilai yang dikandungnya.

Saat Anda menangani RowErrorTextNeeded peristiwa dan menentukan teks kesalahan di handler, glyph kesalahan muncul di header baris kecuali ShowRowErrors properti diatur ke false. Saat pengguna memindahkan penunjuk mouse ke glyph kesalahan, teks kesalahan muncul di TipsAlat.

Peristiwa juga RowErrorTextNeeded terjadi setiap kali nilai DataGridViewRow.ErrorText properti diambil.

Anda dapat menggunakan DataGridViewRowErrorTextNeededEventArgs.RowIndex properti untuk menentukan status baris atau nilai yang dikandungnya, dan menggunakan informasi ini untuk mengubah atau mengubah DataGridViewRowErrorTextNeededEventArgs.ErrorText properti. Properti ini diinisialisasi dengan nilai properti baris ErrorText , yang ditimpa nilai peristiwa.

RowErrorTextNeeded Tangani peristiwa saat bekerja dengan data dalam jumlah besar untuk menghindari penalti performa pengaturan nilai baris ErrorText untuk beberapa baris. Untuk informasi selengkapnya, lihat Praktik Terbaik untuk Menskalakan Kontrol Formulir Windows DataGridView.

Untuk informasi selengkapnya tentang cara menangani peristiwa, lihat Menangani dan Menaikkan Peristiwa.

Lihat juga

• DataSource
• VirtualMode
• ShowRowErrors
• DataGridViewRowErrorTextNeededEventHandler
• DataGridViewRowErrorTextNeededEventArgs
• ErrorText
• ErrorText
• OnRowErrorTextNeeded(DataGridViewRowErrorTextNeededEventArgs)
• Kontrol DataGridView (Formulir Windows)