BindingSource.AddingNew 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 sebelum item ditambahkan ke daftar yang mendasar.
public:
event System::ComponentModel::AddingNewEventHandler ^ AddingNew;
public event System.ComponentModel.AddingNewEventHandler AddingNew;
public event System.ComponentModel.AddingNewEventHandler? AddingNew;
member this.AddingNew : System.ComponentModel.AddingNewEventHandler
Public Custom Event AddingNew As AddingNewEventHandler
Jenis Acara
Pengecualian
NewObject bukan tipe yang sama dengan tipe yang terkandung dalam daftar.
Contoh
Contoh kode berikut menggunakan BindingSource komponen untuk mengikat daftar ke DataGridView kontrol. Item baru ditambahkan ke daftar oleh penanganan AddingNew aktivitas. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan dalam Cara: Menyesuaikan Penambahan Item dengan Formulir Windows BindingSource.
// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender,
AddingNewEventArgs^ e)
{
e->NewObject = DemoCustomer::CreateNewCustomer();
}
// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
object sender,
AddingNewEventArgs e)
{
e.NewObject = DemoCustomer.CreateNewCustomer();
}
' This event handler provides custom item-creation behavior.
Private Sub customersBindingSource_AddingNew( _
ByVal sender As Object, _
ByVal e As AddingNewEventArgs) _
Handles customersBindingSource.AddingNew
e.NewObject = DemoCustomer.CreateNewCustomer()
End Sub
Keterangan
Peristiwa AddingNew terjadi sebelum objek baru ditambahkan ke daftar yang mendasar yang diwakili oleh List properti . Kejadian ini diaktifkan setelah metode dipanggil AddNew , tetapi sebelum item baru dibuat dan ditambahkan ke daftar yang mendasar. Dengan menangani peristiwa ini, programmer dapat menyediakan pembuatan item kustom dan perilaku penyisipan tanpa dipaksa untuk berasal dari BindingSource kelas . Ini dicapai di penanganan aktivitas dengan mengatur NewObject properti System.ComponentModel.AddingNewEventArgs parameter ke item baru. Objek baru yang dibuat dalam AddingNew peristiwa harus memiliki jenis yang sama dengan jenis yang terkandung dalam daftar atau pengecualian akan terjadi. Anda tidak dapat mengatur NewObject properti ketika terikat ke DataView atau DataTable karena Anda tidak dapat menambahkan yang baru DataRowView ke daftar.
Untuk informasi selengkapnya tentang menyediakan fungsionalitas item baru kustom, lihat AddNew metode . Untuk informasi selengkapnya tentang menangani peristiwa, lihat Menangani dan Menaikkan Peristiwa.