ICancelAddNew Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dodaje możliwość transakcyjną podczas dodawania nowego elementu do kolekcji.
public interface class ICancelAddNewpublic interface ICancelAddNewtype ICancelAddNew = interfacePublic 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:
Starszy model opiera się bezpośrednio na kolekcji, która implementuje IBindingList interfejs i jest powiązana bezpośrednio z danymi przy użyciu System.Windows.Forms.CurrencyManager klasy . Metody AddNewSystem.Windows.Forms.CurrencyManager , EndCurrentEditi CancelCurrentEdit klasy są odpowiedzialne za obsługę transakcyjną dodawania nowych elementów. Jednak ta funkcja zależy od elementów obsługujących zachowanie transakcyjne za pośrednictwem interfejsu IEditableObject . Jeśli elementy nie obsługują tego interfejsu, element będzie zawsze dodawany do listy, niezależnie od kolejnych wywołań metody CancelCurrentEdit.
Nowszy model obsługuje bardziej niezawodny scenariusz powiązania danych za pośrednictwem klasy ogólnej BindingList<T> , która implementuje IBindingList interfejsy i ICancelAddNew . W takim przypadku obsługa transakcyjna jest zarządzana bezpośrednio przez BindingList<T> kolekcję.
Metody
| CancelNew(Int32) |
Odrzuca oczekujący nowy element z kolekcji. |
| EndNew(Int32) |
Zatwierdza oczekujący nowy element do kolekcji. |
