ICancelAddNew Interfejs

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.TypeConverter.dll

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

public interface class ICancelAddNew

public interface ICancelAddNew

type ICancelAddNew = interface

Public Interface ICancelAddNew

Pochodne

System.ComponentModel.BindingList<T>

System.Windows.Forms.BindingSource

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.

Zobacz też

• IBindingList
• CurrencyManager
• IEditableObject
• BindingList<T>