Udostępnij za pośrednictwem


ICancelAddNew Interfejs

Definicja

Dodaje możliwość transakcyjną podczas dodawania nowego elementu do kolekcji.

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

Uwagi

Interfejs ICancelAddNew umożliwia kolekcji dodawanie nowego elementu w rozszerzalny sposób. Nowy element można następnie zatwierdzać lub cofać. Metoda AddNew kolekcji jest używana do wstępnego dodawania elementu, który jest następnie wykonywany za pomocą następujących operacji:

  • Metoda EndNew jawnie zatwierdzi oczekujące dodanie.

  • Wykonanie innej operacji zbierania, takiej jak wstawienie, usunięcie lub przeniesienie, spowoduje niejawne zatwierdzenie oczekującego dodania.

  • Metoda CancelNew wycofa oczekujące dodanie, jeśli nie została jeszcze zatwierdzona.

Uwaga

W niektórych scenariuszach, takich jak Windows Forms złożone powiązanie danych, kolekcja może odbierać CancelNew lub EndNew wywołuje elementy inne niż nowo dodany element. (Każdy element jest zazwyczaj wierszem w widoku danych). Ignoruj te wywołania; anuluj lub zatwierdź nowy element tylko wtedy, gdy zostanie określony indeks tego elementu.

Istnieją dwa modele, które umożliwiają transakcyjne dodawanie elementu do kolekcji powiązanej z danymi:

Metody

CancelNew(Int32)

Odrzuca oczekujący nowy element z kolekcji.

EndNew(Int32)

Zatwierdza oczekujący nowy element do kolekcji.

Dotyczy

Zobacz też