IBindingList.AddNew Methode

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Fügt der Liste ein neues Element hinzu.

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Gibt zurück

Object

Das der Liste hinzugefügte Element.

Ausnahmen

NotSupportedException

AllowNew ist false.

Hinweise

Diese Methode wird nur unterstützt, wenn AllowNew ist true, andernfalls wird eine NotSupportedException ausgelöst.

Die Implementierung dieser Methode bedeutet, dass die IBindingList Liste den Typ der Objekte verstehen muss, die der Liste hinzugefügt werden sollen, und dass sie verstehen muss, wie eine neue instance dieses Typs erstellt werden kann. Wenn Sie beispielsweise über eine Auflistung von myCustomer -Objekten verfügen, sollte die AddNew -Methode der Liste ein neues myCustomer -Objekt hinzufügen.

Hinweis

Wenn die Objekte in dieser Liste die IEditableObject -Schnittstelle implementieren, sollte beim Aufrufen der CancelEdit -Methode ein -Objekt verworfen und nicht der Liste hinzugefügt werden, wenn das Objekt mit der AddNew -Methode erstellt wurde. Das -Objekt sollte der Liste nur hinzugefügt werden, wenn die IEditableObject.EndEdit -Methode aufgerufen wird. Daher müssen Sie das Objekt und die Liste sorgfältig synchronisieren.

Wenn diese Methode aufgerufen wird, sollten Sie ein ListChanged Ereignis auslösen, bei dem die ItemAdded Enumeration den entsprechenden Index enthält. Die hinzugefügte Zeile befindet sich in einem Zustand, in dem das Drücken von ESC für ein DataGridView Steuerelement die neue Zeile entfernen kann. Das Auslösen des Ereignisses ListChanged mit der ItemAdded -Enumeration ein zweites Mal in dieser Zeile bedeutet, dass das Element jetzt eine normale Zeile (nicht im neuen Zustand) ist.