ICancelAddNew Antarmuka

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Sumber:

ICancelAddNew.cs

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 EndNew akan secara eksplisit mengkonfirmasi penambahan yang tertunda.

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

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

Note

Dalam beberapa skenario, seperti Formulir Windows pengikatan data kompleks, koleksi mungkin menerima panggilan CancelNew atau EndNew untuk 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 pada item ke koleksi terikat data:

• Model lama bergantung langsung pada koleksi yang mengimplementasikan antarmuka IBindingList dan terikat data secara langsung menggunakan kelas System.Windows.Forms.CurrencyManager. Metode AddNew, EndCurrentEdit, dan CancelCurrentEdit dari kelas System.Windows.Forms.CurrencyManager bertanggung jawab atas dukungan transaksional untuk menambahkan item baru. Namun, fungsionalitas ini tergantung pada item yang mendukung perilaku transaksional melalui IEditableObject 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

Nama	Deskripsi
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>