IBindingList.AddNew Metoda
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 nowy element do listy.
public:
System::Object ^ AddNew();public object AddNew ();public object? AddNew ();abstract member AddNew : unit -> objPublic Function AddNew () As ObjectZwraca
Element dodany do listy.
Wyjątki
AllowNew to false.
Uwagi
Ta metoda jest obsługiwana tylko wtedy, gdy AllowNew jest trueto ; w przeciwnym razie NotSupportedException jest zgłaszana wartość .
Implementacja tej metody oznacza, że IBindingList lista musi zrozumieć typ obiektów do dodania do listy i musi zrozumieć, jak utworzyć nowe wystąpienie tego typu. Jeśli na przykład masz kolekcję myCustomer obiektów, AddNew metoda powinna dodać nowy myCustomer obiekt do listy.
Uwaga
Jeśli obiekty na tej liście implementują IEditableObject interfejs, wywołanie CancelEdit metody powinno odrzucić obiekt, a nie dodać go do listy, gdy obiekt został utworzony przy użyciu AddNew metody . Obiekt powinien być dodawany tylko do listy po wywołaniu IEditableObject.EndEdit metody. W związku z tym należy dokładnie zsynchronizować obiekt i listę.
Po wywołaniu tej metody należy zgłosić ListChanged zdarzenie z ItemAdded wyliczeniem zawierającym odpowiedni indeks. Dodany wiersz jest w stanie, w którym naciśnięcie klawisza Esc w kontrolce DataGridView może usunąć nowy wiersz. ListChanged Podniesienie zdarzenia przy użyciu ItemAdded wyliczenia po raz drugi w tym wierszu wskazuje, że element jest teraz normalnym wierszem (nie w nowym stanie).
