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

定義

リストに新しい項目を追加します。Adds a new item to the list.

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

戻り値

リストに追加された項目。The item added to the list.

例外

注釈

場合にのみ、このメソッドがサポートされてAllowNewtrue、それ以外のNotSupportedExceptionがスローされます。This method is supported only if AllowNew is true; otherwise, a NotSupportedException is thrown.

このメソッドを実装することを意味、IBindingList一覧リストに追加するオブジェクトの種類を把握する必要があり、その型の新しいインスタンスを作成する方法を理解する必要があります。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. コレクションがある場合などmyCustomerオブジェクト、AddNewメソッドを追加する必要があります、新しいmyCustomerリストに、オブジェクト。For example, if you have a collection of myCustomer objects, the AddNew method should add a new myCustomer object to the list.

注意

このリスト内のオブジェクトを実装する場合、IEditableObjectインターフェイスを呼び出し、CancelEditメソッドする必要がありますオブジェクトを破棄しないに追加してください、リストを使用して、オブジェクトの作成時に、AddNewメソッド。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. オブジェクトは、一覧にのみ追加する必要があるときに、IEditableObject.EndEditメソッドが呼び出されます。The object should only be added to the list when the IEditableObject.EndEdit method is called. したがって、オブジェクトと、一覧を慎重に同期する必要があります。Therefore, you must synchronize the object and the list carefully.

このメソッドが呼び出されたときに発生させる、ListChangedイベントをItemAdded列挙型の適切なインデックスを実行します。When this method is called, you should raise a ListChanged event with the ItemAdded enumeration carrying the appropriate index. 追加された行が、状態 esc キーを押す場合、DataGridViewコントロールは、新しい行を削除できます。The added row is in a state where hitting Esc on a DataGridView control can remove the new row. 発生させる、ListChangedイベントをItemAdded列挙体のこの行で 2 回目では、項目がようになりました (新しい状態) ではなく通常の行を示します。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).

適用対象