ICancelAddNew Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt beim Erweitern einer Auflistung um ein neues Element Transaktionsfähigkeit hinzu.
public interface class ICancelAddNewpublic interface ICancelAddNewtype ICancelAddNew = interfacePublic Interface ICancelAddNew- Abgeleitet
Hinweise
Die ICancelAddNew -Schnittstelle ermöglicht es einer Auflistung, ein neues Element auf erweiterbare Weise hinzuzufügen. Das neue Element kann anschließend committet oder zurückgesetzt werden. Die AddNew -Methode der Auflistung wird verwendet, um das Element vorläufig hinzuzufügen, das anschließend über die folgenden Vorgänge ausgeführt wird:
Mit der EndNew-Methode wird die ausstehende Hinzufügung explizit committet.
Wenn Sie einen anderen Sammlungsvorgang ausführen, z. B. ein Einfügen, Entfernen oder Verschieben, wird das ausstehende Hinzufügen implizit committen.
Die CancelNew -Methode führt ein Rollback für die ausstehende Hinzufügung aus, wenn noch kein Commit ausgeführt wurde.
Hinweis
In einigen Szenarien, z. B. Windows Forms komplexen Datenbindung, empfängt CancelNew die Sammlung möglicherweise andere Elemente als das neu hinzugefügte Element oder EndNew ruft diese auf. (Jedes Element ist in der Regel eine Zeile in einer Datenansicht.) Ignorieren Sie diese Aufrufe. Abbrechen oder Committen des neuen Elements nur, wenn der Index dieses Elements angegeben ist.
Es gibt zwei Modelle, die das transaktionsbezogene Hinzufügen eines Elements zu einer datengebundenen Sammlung ermöglichen:
Das ältere Modell basiert direkt auf einer Auflistung, die die IBindingList -Schnittstelle implementiert und direkt mithilfe der System.Windows.Forms.CurrencyManager -Klasse datengebunden ist. Die AddNewMethoden , EndCurrentEditund CancelCurrentEdit der -Klasse sind für die System.Windows.Forms.CurrencyManager Transaktionsunterstützung für das Hinzufügen neuer Elemente verantwortlich. Diese Funktionalität hängt jedoch von den Elementen ab, die das Transaktionsverhalten über die IEditableObject -Schnittstelle unterstützen. Wenn die Elemente diese Schnittstelle nicht unterstützen, wird das Element immer der Liste hinzugefügt, unabhängig von nachfolgenden Aufrufen CancelCurrentEditvon .
Das neuere Modell unterstützt ein stabileres Datenbindungsszenario über die generische BindingList<T> Klasse, die die IBindingList Schnittstellen und ICancelAddNew implementiert. In diesem Fall wird die Transaktionsunterstützung direkt von der BindingList<T> Auflistung verwaltet.
Methoden
| CancelNew(Int32) |
Entfernt ein anstehendes neues Element aus der Auflistung. |
| EndNew(Int32) |
Übergibt ein anstehendes neues Element an die Auflistung. |
