IBindingList.AddNew IBindingList.AddNew IBindingList.AddNew IBindingList.AddNew Method

Definition

Fügt der Liste ein neues Element hinzu.Adds a new item to the list.

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

Gibt zurück

Das der Liste hinzugefügte Element.The item added to the list.

Ausnahmen

Hinweise

Diese Methode wird nur unterstützt, wenn AllowNew ist trueist, andernfalls eine NotSupportedException ausgelöst.This method is supported only if AllowNew is true; otherwise, a NotSupportedException is thrown.

Implementieren diese Methode bedeutet, dass die IBindingList Liste müssen verstehen, den Typ von Objekten, die zur Liste hinzuzufügen, und müssen wissen, wie eine neue Instanz dieses Typs zu erstellen.Implementing this method means that the IBindingList list must understand the type of objects to add to the list and must understand how to create a new instance of that type. Für, wenn Sie z. B. eine Auflistung von myCustomer Objekte, die AddNew sollten fügen Sie eine neue Methode myCustomer Objekt, das der Liste.For example, if you have a collection of myCustomer objects, the AddNew method should add a new myCustomer object to the list.

Hinweis

Wenn die Objekte in der Liste implementieren die IEditableObject -Schnittstelle Aufrufen der CancelEdit Methode sollte ein Objekt zu verwerfen, nicht zur Liste hinzufügen, wenn das Objekt erstellt wurde, mithilfe der AddNew Methode.If the objects in this list implement the IEditableObject interface, calling the CancelEdit method should discard an object, not add it to the list, when the object was created using the AddNew method. Das Objekt sollte nur zur Liste hinzugefügt werden bei der IEditableObject.EndEdit Methode wird aufgerufen.The object should only be added to the list when the IEditableObject.EndEdit method is called. Aus diesem Grund müssen Sie das Objekt und die Liste sorgfältig synchronisieren.Therefore, you must synchronize the object and the list carefully.

Wenn diese Methode aufgerufen wird, müssen Sie Auslösen einer ListChanged -Ereignis mit der ItemAdded Enumeration, die den entsprechenden Index.When this method is called, you should raise a ListChanged event with the ItemAdded enumeration carrying the appropriate index. Die hinzugefügte Zeile, die in einem Zustand befindet, drücken ESC-Taste auf ein DataGridView -Steuerelement kann die neue Zeile zu entfernen.The added row is in a state where hitting Esc on a DataGridView control can remove the new row. Auslösen der ListChanged -Ereignis mit der ItemAdded Enumeration ein zweites Mal in dieser Zeile gibt an, dass das Element jetzt eine normale Zeile (nicht im neuen Zustand).Raising the ListChanged event with the ItemAdded enumeration a second time on this row indicates that the item is now a normal row (not in new state).

Gilt für: