DataGridView.DefaultValuesNeeded Kejadian

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Terjadi ketika pengguna memasukkan baris untuk rekaman baru sehingga dapat diisi dengan nilai default.

public:
 event System::Windows::Forms::DataGridViewRowEventHandler ^ DefaultValuesNeeded;

public event System.Windows.Forms.DataGridViewRowEventHandler DefaultValuesNeeded;

member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler 

Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler 

Jenis Acara

DataGridViewRowEventHandler

Contoh

Contoh kode berikut menggambarkan bagaimana peristiwa ini dapat ditangani. Dalam contoh, sel untuk kolom yang diberikan diisi dengan nilai default. CustomerID Untuk kolom , nilai diambil dari metode terpisah (tidak diimplementasikan) yang menghasilkan ID pelanggan unik.

Untuk menjalankan contoh ini, ganti nama kolom dengan nama objek kolom dari kontrol aktual DataGridView dan berikan nilai default yang sesuai. Saat menentukan kolom menurut nama, Anda harus menggunakan nama objek kolom dan bukan teks header kolom.

private void dataGridView1_DefaultValuesNeeded(object sender,
    System.Windows.Forms.DataGridViewRowEventArgs e)
{
    e.Row.Cells["Region"].Value = "WA";
    e.Row.Cells["City"].Value = "Redmond";
    e.Row.Cells["PostalCode"].Value = "98052-6399";
    e.Row.Cells["Country"].Value = "USA";
    e.Row.Cells["CustomerID"].Value = NewCustomerId();
}

Private Sub dataGridView1_DefaultValuesNeeded(ByVal sender As Object, _
    ByVal e As System.Windows.Forms.DataGridViewRowEventArgs) _
    Handles dataGridView1.DefaultValuesNeeded

    With e.Row
        .Cells("Region").Value = "WA"
        .Cells("City").Value = "Redmond"
        .Cells("PostalCode").Value = "98052-6399"
        .Cells("Country").Value = "USA"
        .Cells("CustomerID").Value = NewCustomerId()
    End With

End Sub

Keterangan

Kejadian ini memungkinkan Anda mengisi baris untuk rekaman baru saat pengguna memasukkan baris. Nilai awal untuk baris berasal dari DefaultNewRowValue properti yang DataGridViewCell dikembalikan oleh properti setiap kolom CellTemplate .

Dalam mode terikat data, semua nilai sel untuk kolom terikat data disimpan di sumber data eksternal. Saat pengguna memasukkan baris untuk rekaman baru, baris baru dibuat di sumber data sebelum DefaultValuesNeeded peristiwa terjadi. Saat Anda mengisi DataGridViewRowEventArgs.Row properti di penanganan aktivitas Anda, nilai ditambahkan langsung ke sumber data.

Dalam mode virtual, setelah peristiwa ini terjadi, CellValuePushed peristiwa terjadi untuk setiap sel di baris baru sehingga Anda dapat menyimpan nilai default di penyimpanan data kustom Anda. Kemudian, CellValueNeeded peristiwa terjadi untuk setiap sel di baris baru, mengambil nilai yang Anda simpan dalam CellValuePushed peristiwa, yang kemudian ditampilkan.

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

Lihat juga

• Kontrol DataGridView (Formulir Windows)