ICancelAddNew Gränssnitt
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Lägger till transaktionsfunktioner när du lägger till ett nytt objekt i en samling.
public interface class ICancelAddNewpublic interface ICancelAddNewtype ICancelAddNew = interfacePublic Interface ICancelAddNew- Härledda
Kommentarer
Med ICancelAddNew gränssnittet kan en samling lägga till ett nytt objekt på ett utökningsbart sätt. Det nya objektet kan sedan checkas in eller återställas. Metoden AddNew för samlingen används för att preliminärt lägga till objektet, som sedan transacted genom följande åtgärder:
EndNew-metoden kommer att uttryckligen committera den väntande tillägget.
Om du utför en annan samlingsåtgärd, till exempel en infogning, borttagning eller flytt, checkas den väntande tillägget implicit in.
Metoden CancelNew återställer det väntande tillägget om det inte redan har checkats in.
Note
I vissa scenarier, till exempel Windows Forms komplex databindning, kan samlingen ta emot CancelNew eller EndNew anrop för andra objekt än det nyligen tillagda objektet. (Varje objekt är vanligtvis en rad i en datavy.) Ignorera dessa anrop. avbryt eller checka endast in det nya objektet när objektets index har angetts.
Det finns två modeller som tillåter transaktionell tillägg av ett objekt till en databunden samling:
Den äldre modellen förlitar sig direkt på en samling som implementerar gränssnittet IBindingList och är databunden direkt med klassen System.Windows.Forms.CurrencyManager. Metoderna AddNew, EndCurrentEdit och CancelCurrentEdit i klassen System.Windows.Forms.CurrencyManager ansvarar för transaktionsstöd för att lägga till nya objekt. Den här funktionen beror dock på vilka objekt som stöder transaktionsbeteende via IEditableObject gränssnittet. Om objekten inte stöder det här gränssnittet läggs objektet alltid till i listan, oavsett efterföljande anrop till CancelCurrentEdit.
Den nyare modellen stöder ett mer robust databindningsscenario via den generiska BindingList<T> klassen, som implementerar gränssnitten IBindingList och ICancelAddNew . I det här fallet hanteras transaktionsstödet direkt av BindingList<T> samlingen.
Metoder
| Name | Description |
|---|---|
| CancelNew(Int32) |
Tar bort ett väntande nytt objekt från samlingen. |
| EndNew(Int32) |
Checkar in ett väntande nytt objekt i samlingen. |