IBindingList.AddNew-Methode
Fügt der Liste ein neues Element hinzu.
Namespace: System.ComponentModel
Assembly: System (in system.dll)
Syntax
'Declaration
Function AddNew As Object
'Usage
Dim instance As IBindingList
Dim returnValue As Object
returnValue = instance.AddNew
Object AddNew ()
Object^ AddNew ()
Object AddNew ()
function AddNew () : Object
Rückgabewert
Das der Liste hinzugefügte Element.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
AllowNew ist false. |
Hinweise
Diese Methode wird nur unterstützt, wenn AllowNewtrue ist. Andernfalls wird eine NotSupportedException ausgelöst.
Das Implementieren dieser Methode bedeutet, dass der IBindingList-Liste der Typ des hinzuzufügenden Objekts sowie die Vorgehensweise zum Erstellen einer neuen Instanz dieses Typs bekannt sind. 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 ein Objekt durch Aufruf der CancelEdit-Methode verworfen und nicht der Liste hinzugefügt werden, sofern es unter Verwendung der AddNew-Methode erstellt wurde. Das Objekt sollte der Liste nur dann hinzugefügt werden, wenn die IEditableObject.EndEdit-Methode aufgerufen wird. Daher müssen Objekt und Liste sorgfältig synchronisiert werden.
Wenn diese Methode aufgerufen wird, müssen Sie ein ListChanged-Ereignis mit der ItemAdded-Enumeration auslösen, die den entsprechenden Index enthält. Die hinzugefügte Zeile befindet sich in einem Zustand, in dem sie durch Drücken von ESC für ein DataGridView-Steuerelement entfernt werden kann. Wenn das ListChanged-Ereignis mit der ItemAdded-Enumeration zum zweiten Mal für diese Zeile ausgelöst wird, wird die Zeile zu einer normalen Zeile (sie ist dann keine neue Zeile mehr).
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
IBindingList-Schnittstelle
IBindingList-Member
System.ComponentModel-Namespace