DataGridViewDataErrorContexts Enum

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mewakili status kontrol terikat DataGridView data saat terjadi kesalahan data.

Enumerasi ini mendukung kombinasi bitwise dari nilai yang termasuk di dalamnya.

public enum class DataGridViewDataErrorContexts

[System.Flags]
public enum DataGridViewDataErrorContexts

[<System.Flags>]
type DataGridViewDataErrorContexts = 

Public Enum DataGridViewDataErrorContexts

Warisan

Object

ValueType

Enum

DataGridViewDataErrorContexts

Atribut

FlagsAttribute

Bidang

ClipboardContent	16384	Terjadi kesalahan data saat menyalin konten ke Clipboard. Nilai ini menunjukkan bahwa nilai sel tidak dapat dikonversi menjadi string.
Commit	512	Terjadi kesalahan data saat melakukan perubahan pada penyimpanan data. Nilai ini menunjukkan bahwa data yang dimasukkan dalam sel tidak dapat diterapkan ke penyimpanan data yang mendasar.
CurrentCellChange	4096	Terjadi kesalahan data saat kursor pilihan dipindahkan ke sel lain. Nilai ini menunjukkan bahwa pengguna memilih sel saat sel yang dipilih sebelumnya memiliki kondisi kesalahan.
Display	2	Terjadi kesalahan data saat menampilkan sel yang diisi oleh sumber data. Nilai ini menunjukkan bahwa nilai dari sumber data tidak dapat ditampilkan oleh sel, atau pemetaan yang menerjemahkan nilai dari sumber data ke sel hilang.
Formatting	1	Terjadi kesalahan data saat mencoba memformat data yang sedang dikirim ke penyimpanan data, atau dimuat dari penyimpanan data. Nilai ini menunjukkan bahwa perubahan pada sel gagal diformat dengan benar. Nilai sel baru perlu dikoreksi atau pemformatan sel perlu diubah.
InitialValueRestoration	1024	Terjadi kesalahan data saat memulihkan sel ke nilai sebelumnya. Nilai ini menunjukkan bahwa sel mencoba membatalkan pengeditan dan pembatalan ke nilai awal gagal. Ini dapat terjadi jika pemformatan sel berubah sehingga tidak kompatibel dengan nilai awal.
LeaveControl	2048	Terjadi kesalahan data saat DataGridView kehilangan fokus. Nilai ini menunjukkan bahwa DataGridView pengguna tidak dapat melakukan perubahan setelah kehilangan fokus.
Parsing	256	Terjadi kesalahan data saat mengurai data baru. Nilai ini menunjukkan bahwa DataGridView tidak dapat mengurai data baru yang dimasukkan oleh pengguna atau dimuat dari penyimpanan data yang mendasar.
PreferredSize	4	Terjadi kesalahan data saat menghitung ukuran sel pilihan. Nilai ini menunjukkan bahwa DataGridView gagal menghitung lebar atau tinggi sel pilihan saat mengubah ukuran kolom atau baris secara terprogram. Ini dapat terjadi jika sel gagal memformat nilainya.
RowDeletion	8	Terjadi kesalahan data saat menghapus baris. Nilai ini menunjukkan bahwa penyimpanan data yang mendasar melemparkan pengecualian saat terikat DataGridView data menghapus baris.
Scroll	8192	Terjadi kesalahan data saat menggulir wilayah baru ke tampilan. Nilai ini menunjukkan bahwa sel dengan kesalahan data digulir ke tampilan secara terprogram atau dengan bilah gulir.

Contoh

Contoh kode berikut mengilustrasikan penggunaan jenis ini. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia di Cara: Menangani Kesalahan yang Terjadi Selama Entri Data di kontrol Formulir Windows DataGridView.

private void dataGridView1_DataError(object sender,
    DataGridViewDataErrorEventArgs e)
{
    // If the data source raises an exception when a cell value is 
    // commited, display an error message.
    if (e.Exception != null &&
        e.Context == DataGridViewDataErrorContexts.Commit)
    {
        MessageBox.Show("CustomerID value must be unique.");
    }
}

Private Sub dataGridView1_DataError(ByVal sender As Object, _
    ByVal e As DataGridViewDataErrorEventArgs) _
    Handles dataGridView1.DataError

    ' If the data source raises an exception when a cell value is 
    ' commited, display an error message.
    If e.Exception IsNot Nothing AndAlso _
        e.Context = DataGridViewDataErrorContexts.Commit Then

        MessageBox.Show("CustomerID value must be unique.")

    End If

End Sub

Keterangan

Anggota enumerasi ini dapat digabungkan menggunakan operasi BITWISE OR untuk mewakili status terikat DataGridView data saat terjadi kesalahan data. Misalnya, jika pengguna memasukkan nilai sel yang tidak valid (seperti memasukkan nama dalam sel yang mengharapkan tanggal) lalu memilih sel yang berbeda, DataGridView akan mencoba menerapkan nilai sel yang tidak valid. Ketika penerapan gagal, DataGridView akan memunculkan DataError peristiwa yang propertinya Context akan memiliki nilai Commit dan CurrentCellChange.

Lihat juga

• DataGridView
• DataError
• Context