IBindingList.AddNew Metode
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.
Menambahkan item baru ke daftar.
public:
System::Object ^ AddNew();
public object AddNew ();
public object? AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object
Mengembalikan
Item ditambahkan ke daftar.
Pengecualian
AllowNewadalah false
.
Keterangan
Metode ini hanya didukung jika AllowNew adalah true
; jika tidak, akan NotSupportedException dilemparkan.
Menerapkan metode ini berarti bahwa IBindingList daftar harus memahami jenis objek untuk ditambahkan ke daftar dan harus memahami cara membuat instans baru dari jenis tersebut. Misalnya, jika Anda memiliki kumpulan myCustomer
objek, AddNew metode harus menambahkan objek baru myCustomer
ke daftar.
Catatan
Jika objek dalam daftar ini mengimplementasikan IEditableObject antarmuka, memanggil CancelEdit metode harus membuang objek, bukan menambahkannya ke daftar, ketika objek dibuat menggunakan AddNew metode . Objek hanya boleh ditambahkan ke daftar ketika metode dipanggil IEditableObject.EndEdit . Oleh karena itu, Anda harus menyinkronkan objek dan daftar dengan hati-hati.
Ketika metode ini dipanggil, Anda harus menaikkan ListChanged peristiwa dengan ItemAdded enumerasi yang membawa indeks yang sesuai. Baris yang ditambahkan berada dalam status di mana menekan Esc pada DataGridView kontrol dapat menghapus baris baru. Menaikkan ListChanged peristiwa dengan ItemAdded enumerasi untuk kedua kalinya pada baris ini menunjukkan bahwa item sekarang adalah baris normal (bukan dalam status baru).