IBindingList.AddNew Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Liste ein neues Element hinzu.
public:
System::Object ^ AddNew();
public object AddNew ();
public object? AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object
Gibt zurück
Das der Liste hinzugefügte Element.
Ausnahmen
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.