ICancelAddNew Antarmuka

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

System.ComponentModel.TypeConverter.dll

Menambahkan kemampuan transaksi saat menambahkan item baru ke koleksi.

public interface class ICancelAddNew

public interface ICancelAddNew

type ICancelAddNew = interface

Public Interface ICancelAddNew

Turunan

System.ComponentModel.BindingList<T>

System.Windows.Forms.BindingSource

Keterangan

Antarmuka ICancelAddNew memungkinkan koleksi untuk menambahkan item baru dengan cara yang dapat diperluas. Item baru kemudian dapat diterapkan atau digulung balik. Metode AddNew pengumpulan digunakan untuk menambahkan item secara tentatif, yang kemudian ditransaksikan melalui operasi berikut:

• Metode ini EndNew akan secara eksplisit menerapkan penambahan yang tertunda.

• Melakukan operasi pengumpulan lain, seperti penyisipan, penghapusan, atau pemindahan akan secara implisit menerapkan penambahan yang tertunda.

• Metode ini CancelNew akan mengembalikan penambahan yang tertunda jika belum dilakukan.

Catatan

Dalam beberapa skenario, seperti Formulir Windows pengikatan data yang kompleks, koleksi mungkin menerima CancelNew atau EndNew memanggil item selain item yang baru ditambahkan. (Setiap item biasanya berupa baris dalam tampilan data.) Abaikan panggilan ini; batalkan atau terapkan item baru hanya ketika indeks item tersebut ditentukan.

Ada dua model yang memungkinkan penambahan transaksi item ke koleksi terikat data:

• Model lama bergantung langsung pada koleksi yang mengimplementasikan IBindingList antarmuka dan terikat data secara langsung menggunakan System.Windows.Forms.CurrencyManager kelas . Metode AddNew, EndCurrentEdit, dan CancelCurrentEdit kelas System.Windows.Forms.CurrencyManager bertanggung jawab atas dukungan transaksional untuk menambahkan item baru. Namun, fungsionalitas ini tergantung pada item yang mendukung perilaku transaksional IEditableObject melalui antarmuka. Jika item tidak mendukung antarmuka ini, item akan selalu ditambahkan ke daftar, terlepas dari panggilan berikutnya ke CancelCurrentEdit.

• Model yang lebih baru mendukung skenario pengikatan data yang lebih kuat melalui kelas generik BindingList<T> , yang mengimplementasikan IBindingList antarmuka dan ICancelAddNew . Dalam hal ini, dukungan transaksi dikelola oleh koleksi secara BindingList<T> langsung.

Metode

CancelNew(Int32)	Membuang item baru yang tertunda dari koleksi.
EndNew(Int32)	Menerapkan item baru yang tertunda ke koleksi.

Lihat juga

• IBindingList
• CurrencyManager
• IEditableObject
• BindingList<T>