IBindingList.AddNew メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
リストに新しい項目を追加します。
public:
System::Object ^ AddNew();public object? AddNew();public object AddNew();abstract member AddNew : unit -> objPublic Function AddNew () As Object返品
リストに追加された項目。
例外
AllowNew は falseです。
注釈
このメソッドは、 AllowNew が trueされている場合にのみサポートされます。それ以外の場合は、 NotSupportedException がスローされます。
このメソッドを実装すると、 IBindingList リストは、リストに追加するオブジェクトの種類を理解し、その型の新しいインスタンスを作成する方法を理解する必要があることを意味します。 たとえば、 myCustomer オブジェクトのコレクションがある場合、 AddNew メソッドは新しい myCustomer オブジェクトをリストに追加する必要があります。
Note
このリスト内のオブジェクトが IEditableObject インターフェイスを実装している場合、 CancelEdit メソッドを呼び出すと、 AddNew メソッドを使用してオブジェクトが作成されたときに、リストに追加されるのではなく、オブジェクトを破棄する必要があります。 オブジェクトは、 IEditableObject.EndEdit メソッドが呼び出されたときにのみリストに追加する必要があります。 そのため、オブジェクトとリストを慎重に同期する必要があります。
このメソッドが呼び出されると、適切なインデックスを持つListChanged列挙体でItemAdded イベントを発生させる必要があります。 追加された行は、 DataGridView コントロールで Esc キーを押すと新しい行を削除できる状態です。 この行で ListChanged 列挙で ItemAdded イベントを 2 回目に発生させる場合は、アイテムが (新しい状態ではなく) 通常の行になったことを示します。
