ICancelAddNew Interfész
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Tranzakciós képességet ad hozzá, amikor új elemet ad hozzá egy gyűjteményhez.
public interface class ICancelAddNewpublic interface ICancelAddNewtype ICancelAddNew = interfacePublic Interface ICancelAddNew- Származtatott
Megjegyzések
Az ICancelAddNew interfész lehetővé teszi, hogy a gyűjtemény bővíthető módon adjon hozzá egy új elemet. Az új elem később véglegesítheti vagy visszaállítható. A AddNew gyűjtemény módszere az elem feltételes hozzáadására szolgál, amelyet később a következő műveletek hajtanak végre:
A EndNew metódus explicit módon véglegesíti a függőben lévő hozzáadást.
Ha egy másik gyűjteményműveletet hajt végre, például beszúrást, eltávolítást vagy áthelyezést, implicit módon véglegesíti a függőben lévő hozzáadást.
A CancelNew metódus visszaállítja a függőben lévő hozzáadást, ha még nem véglegesítették.
Note
Bizonyos esetekben, például Windows Forms összetett adatkötés esetén a gyűjtemény CancelNew vagy EndNew hívásokat fogadhat az újonnan hozzáadott elemtől eltérő elemekre. (Minden elem általában egy adatnézetben lévő sor.) Figyelmen kívül hagyja ezeket a hívásokat; csak akkor mondja le vagy véglegesítse az új elemet, ha az adott elem indexe meg van adva.
Két modell lehetővé teszi egy elem tranzakciós hozzáadását egy adathoz kötött gyűjteményhez:
A régebbi modell közvetlenül a IBindingList interfészt implementáló gyűjteményre támaszkodik, és közvetlenül az System.Windows.Forms.CurrencyManager osztály használatával kötött. Az AddNew osztály EndCurrentEdit, CancelCurrentEdit és System.Windows.Forms.CurrencyManager metódusai felelősek az új elemek hozzáadásának tranzakciós támogatásáért. Ez a funkció azonban a tranzakciós viselkedést támogató elemektől függ a IEditableObject felületen keresztül. Ha az elemek nem támogatják ezt a felületet, az elem mindig hozzá lesz adva a listához, függetlenül attól, hogy a program milyen további hívásokat indít el CancelCurrentEdit.
Az újabb modell egy robusztusabb adatkötési forgatókönyvet támogat az általános BindingList<T> osztályon keresztül, amely implementálja a felületeket és IBindingList az ICancelAddNew interfészeket. Ebben az esetben a tranzakciós támogatást közvetlenül a BindingList<T> gyűjtemény kezeli.
Metódusok
| Name | Description |
|---|---|
| CancelNew(Int32) |
Elvet egy függőben lévő új elemet a gyűjteményből. |
| EndNew(Int32) |
Függőben lévő új elemet véglegesíti a gyűjteményben. |
