Udostępnij za pośrednictwem


IBindingList.AddNew Metoda

Definicja

Dodaje nowy element do listy.

public:
 System::Object ^ AddNew();
public object AddNew ();
public object? AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object

Zwraca

Element dodany do listy.

Wyjątki

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).

Dotyczy