IBindingList.AddNew メソッド

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.TypeConverter.dll

リストに新しい項目を追加します。

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

戻り値

Object

リストに追加された項目。

例外

NotSupportedException

AllowNew は false です。

注釈

このメソッドは、 が のtrue場合にのみサポートされます。それ以外の場合AllowNewNotSupportedExceptionは がスローされます。

このメソッドを実装することは、リストが IBindingList リストに追加するオブジェクトの種類を理解し、その型の新しいインスタンスを作成する方法を理解する必要があることを意味します。 たとえば、オブジェクトの myCustomer コレクションがある場合、 メソッドは AddNew 新 myCustomer しいオブジェクトをリストに追加する必要があります。

注意

このリスト内のオブジェクトで インターフェイスが IEditableObject 実装されている場合、 メソッドを呼び出すと、 メソッドを CancelEdit 使用してオブジェクトが作成されたときに、オブジェクトをリストに追加せず、破棄する AddNew 必要があります。 オブジェクトは、 メソッドが呼び出されたときにのみリストに追加する IEditableObject.EndEdit 必要があります。 そのため、オブジェクトとリストを慎重に同期する必要があります。

このメソッドが呼び出されると、適切なインデックスを ListChanged 保持する列挙を使用して ItemAdded イベントを発生させる必要があります。 追加された行は、コントロールで Esc DataGridView キーを押すと新しい行を削除できる状態になります。 この行で ListChanged 2 回目の ItemAdded 列挙でイベントを発生させると、アイテムが (新しい状態ではなく) 通常の行になったことが示されます。