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
Parametr AllowNew ma wartość false.
Uwagi
Ta metoda jest obsługiwana tylko wtedy, gdy AllowNew jest true; w przeciwnym razie NotSupportedException zgłaszana jest wartość .
Zaimplementowanie tej metody oznacza, że IBindingList lista musi zrozumieć typ obiektów, które mają zostać dodane do listy i muszą 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.
Note
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 należy dodać do listy tylko wtedy, gdy jest wywoływana IEditableObject.EndEdit metoda. 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. Podniesienie zdarzenia przy ListChangedItemAdded użyciu wyliczenia po raz drugi w tym wierszu wskazuje, że element jest teraz normalnym wierszem (nie w nowym stanie).
