DataGridView.DefaultValuesNeeded Kejadian
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.
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;public event System.Windows.Forms.DataGridViewRowEventHandler? DefaultValuesNeeded;member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler Jenis Acara
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.
