BindingSource.AddingNew イベント

定義

項目が基底のリストに追加される前に発生します。

public:
 event System::ComponentModel::AddingNewEventHandler ^ AddingNew;
public event System.ComponentModel.AddingNewEventHandler AddingNew;
public event System.ComponentModel.AddingNewEventHandler? AddingNew;
member this.AddingNew : System.ComponentModel.AddingNewEventHandler 
Public Custom Event AddingNew As AddingNewEventHandler 

イベントの種類

例外

NewObject の型と、リストに格納されている型が異なります。

次のコード例では、 コンポーネントを BindingSource 使用してリストをコントロールに DataGridView バインドします。 新しい項目は、イベント ハンドラーによってリストに AddingNew 追加されます。 このコード例は、「How to: Customize Item Addition with the Windows フォーム BindingSource」で提供されるより大きな例の一部です。

// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender, 
    AddingNewEventArgs^ e)
{
    e->NewObject = DemoCustomer::CreateNewCustomer();
}
// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
{
    e.NewObject = DemoCustomer.CreateNewCustomer();
}
' This event handler provides custom item-creation behavior.
 Private Sub customersBindingSource_AddingNew( _
 ByVal sender As Object, _
 ByVal e As AddingNewEventArgs) _
 Handles customersBindingSource.AddingNew

     e.NewObject = DemoCustomer.CreateNewCustomer()

 End Sub

注釈

イベントは AddingNew 、 プロパティで表される基になるリストに新しいオブジェクトが追加される前に List 発生します。 このイベントは、 メソッドが AddNew 呼び出された後、新しい項目が作成されて基になるリストに追加される前に発生します。 このイベントを処理することで、プログラマは、クラスから強制的に派生させることなく、カスタム項目の作成と挿入動作を BindingSource 提供できます。 これは、 パラメーターの プロパティSystem.ComponentModel.AddingNewEventArgsを新しい項目にNewObject設定することで、イベント ハンドラーで実現されます。 イベントで作成される AddingNew 新しいオブジェクトは、リストに含まれる型と同じ型である必要があります。または、例外が発生します。 にバインドされている場合、またはDataTableリストにDataView新しい DataRowView を追加できないため、プロパティを設定NewObjectできません。

カスタムの新しい項目機能の提供の詳細については、 メソッドを AddNew 参照してください。 イベントの処理の詳細については、「処理とイベントの発生」を参照してください。

適用対象

こちらもご覧ください