ICancelAddNew Schnittstelle

Definition

Fügt beim Erweitern einer Auflistung um ein neues Element Transaktionsfähigkeit hinzu.Adds transactional capability when adding a new item to a collection.

public interface class ICancelAddNew
public interface ICancelAddNew
type ICancelAddNew = interface
Public Interface ICancelAddNew
Abgeleitet

Hinweise

Die- ICancelAddNew Schnittstelle ermöglicht einer Auflistung das Hinzufügen eines neuen Elements in erweiterbarer Weise.The ICancelAddNew interface enables a collection to add a new item in an extensible way. Anschließend kann ein Commit oder ein Rollback für das neue Element ausgeführt werden.The new item subsequently can be committed or rolled back. Die- AddNew Methode der-Auflistung wird verwendet, um das Element, das anschließend durch die folgenden Vorgänge durchlaufen wird, vorläufig hinzuzufügen:The AddNew method of the collection is used to tentatively add the item, which is subsequently transacted through the following operations:

  • Die- EndNew Methode führt einen expliziten Commit für die ausstehende Addition aus.The EndNew method will explicitly commit the pending addition.

  • Durch das Ausführen eines weiteren Auflistungs Vorgangs (z. b. einfügen, entfernen oder verschieben) wird die ausstehende Addition implizit committ.Performing another collection operation, such as an insertion, removal, or move will implicitly commit the pending addition.

  • Die CancelNew Methode führt ein Rollback für die ausstehende Addition aus, wenn noch kein Commit ausgeführt wurde.The CancelNew method will roll back the pending addition if it has not already been committed.

Hinweis

In einigen Szenarien, z. b. Windows Forms komplexen Daten Bindungen, empfängt die Auflistung möglicherweise Elemente, die CancelNew EndNew nicht das neu hinzugefügte Element sind, oder ruft Sie ab.In some scenarios, such as Windows Forms complex data binding, the collection may receive CancelNew or EndNew calls for items other than the newly added item. (Jedes Element ist in der Regel eine Zeile in einer Datenansicht.) Diese Aufrufe ignorieren; brechen Sie das neue Element ab, oder übergeben Sie es nur dann, wenn der Index des Elements angegeben ist.(Each item is typically a row in a data view.) Ignore these calls; cancel or commit the new item only when that item's index is specified.

Es gibt zwei Modelle, die eine transaktionale Addition eines Elements in eine Daten gebundene Sammlung ermöglichen:There are two models that allow transactional addition of an item to a data-bound collection:

Methoden

CancelNew(Int32)

Entfernt ein anstehendes neues Element aus der Auflistung.Discards a pending new item from the collection.

EndNew(Int32)

Übergibt ein anstehendes neues Element an die Auflistung.Commits a pending new item to the collection.

Gilt für:

Weitere Informationen