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 jenis 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 Windows Forms 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 AddNew metode dipanggil, tetapi sebelum item baru dibuat dan ditambahkan ke daftar yang mendasar. Dengan menangani peristiwa ini, programmer dapat memberikan pembuatan item kustom dan perilaku penyisipan tanpa dipaksa untuk berasal dari BindingSource kelas . Ini dicapai dalam penanganan aktivitas dengan mengatur NewObject properti System.ComponentModel.AddingNewEventArgs parameter ke item baru. Objek baru yang dibuat dalam AddingNew peristiwa harus berjenis 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 baru DataRowView ke daftar.
Untuk informasi selengkapnya tentang menyediakan fungsionalitas item baru kustom, lihat metode .AddNew Untuk informasi selengkapnya tentang menangani peristiwa, lihat Menangani dan Meningkatkan Peristiwa.