ICancelAddNew Antarmuka
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 kemampuan transaksi saat menambahkan item baru ke koleksi.
public interface class ICancelAddNewpublic interface ICancelAddNewtype ICancelAddNew = interfacePublic Interface ICancelAddNew- Turunan
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. |
