Teilen über


ICancelAddNew Schnittstelle

Definition

Fügt beim Erweitern einer Auflistung um ein neues Element Transaktionsfähigkeit hinzu.

public interface class ICancelAddNew
public interface ICancelAddNew
type ICancelAddNew = interface
Public 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:

Methoden

CancelNew(Int32)

Entfernt ein anstehendes neues Element aus der Auflistung.

EndNew(Int32)

Übergibt ein anstehendes neues Element an die Auflistung.

Gilt für:

Weitere Informationen