IBindingList.AddNew Metode

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

System.ComponentModel.TypeConverter.dll

Menambahkan item baru ke daftar.

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Mengembalikan

Object

Item ditambahkan ke daftar.

Pengecualian

NotSupportedException

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).