BindingManagerBase.AddNew メソッド


派生クラスでオーバーライドされると、基になるリストに新しい項目を追加します。When overridden in a derived class, adds a new item to the underlying list.

 abstract void AddNew();
public abstract void AddNew ();
abstract member AddNew : unit -> unit
Public MustOverride Sub AddNew ()


AddNew メソッドは、その項目の型のパラメーターなしのコンストラクターを使用して、基になるリストに新しい項目を追加します。The AddNew method adds a new item to the underlying list by using the parameterless constructor for that item's type. AddNew は、複雑なデータバインディングサポートをカスタムコンポーネントに追加するプログラマが主に使用することを目的としています。AddNew is intended primarily to be used by programmers adding complex data-binding support to their custom component.

AddNew は、通常、アプリケーションプログラマがカスタマイズされた項目を作成するための独自のコードを挿入できるようにするために、次のパターンを使用して実装されます。AddNew is commonly implemented using the following pattern that allows application programmers to inject their own code for creating customized items:

  1. AddNew は、AddingNew イベントを発生させます。AddNew raises the AddingNew event.

  2. プログラマは、AddingNew イベントを処理し、AddingNewEventArgs パラメーターの NewObject プロパティを新しい項目に設定することによって、カスタム項目を提供できます。The programmer can supply a custom item by handling the AddingNew event and setting the NewObject property of the AddingNewEventArgs parameter to the new item. それ以外の場合、コンポーネントは、パラメーターなしのコンストラクターを使用して項目を作成する必要があります。Otherwise, the component should create an item using the parameterless constructor.

  3. データソースに IEditableObject インターフェイスが実装されていない場合は、その項目がすぐにデータソースおよび基になるリストに追加されます。If the data source does not implement the IEditableObject interface, the item is immediately added to the data source and underlying list. このインターフェイスがサポートされている場合、追加は CancelCurrentEdit および EndCurrentEdit メソッドによって処理されます。If this interface is supported, then the addition is transacted by the CancelCurrentEdit and EndCurrentEdit methods.