ICancelAddNew Interfejs

Definicja

Dodaje możliwości transakcyjne podczas dodawania nowego elementu do kolekcji.Adds transactional capability when adding a new item to a collection.

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

Uwagi

ICancelAddNew Interfejs umożliwia kolekcji Dodawanie nowego elementu w rozszerzalny sposób.The ICancelAddNew interface enables a collection to add a new item in an extensible way. Nowy element można następnie zatwierdzić lub wycofać.The new item subsequently can be committed or rolled back. AddNew Metoda kolekcji służy do wstępnego dodania elementu, który następnie jest transakcyjny w ramach następujących operacji:The AddNew method of the collection is used to tentatively add the item, which is subsequently transacted through the following operations:

  • EndNew Metoda jawnie zatwierdzi oczekujące dodanie.The EndNew method will explicitly commit the pending addition.

  • Wykonanie innej operacji kolekcji, takiej jak wstawianie, usuwanie lub przenoszenie, spowoduje niejawne zatwierdzenie oczekującego dodania.Performing another collection operation, such as an insertion, removal, or move will implicitly commit the pending addition.

  • CancelNew Metoda zostanie wycofana jako oczekujące dodanie, jeśli nie została jeszcze zatwierdzona.The CancelNew method will roll back the pending addition if it has not already been committed.

Uwaga

W niektórych scenariuszach, takich jak Windows Forms złożone powiązanie danych, kolekcja może odbierać CancelNew lub EndNew wywoływać elementy inne niż nowo dodany element.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. (Każdy element jest zwykle wierszem w widoku danych). Zignoruj te wywołania; Anuluj lub Zatwierdź nowy element tylko wtedy, gdy jest określony indeks tego elementu.(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.

Istnieją dwa modele, które umożliwiają transakcyjne Dodawanie elementu do kolekcji powiązanej z danymi:There are two models that allow transactional addition of an item to a data-bound collection:

Metody

CancelNew(Int32)

Odrzuca oczekujące nowe elementy z kolekcji.Discards a pending new item from the collection.

EndNew(Int32)

Zatwierdza oczekujące nowe elementy do kolekcji.Commits a pending new item to the collection.

Dotyczy

Zobacz też