AddingNewEventHandler 代理人

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.TypeConverter.dll

AddingNew イベントを処理するメソッドを表します。

public delegate void AddingNewEventHandler(System::Object ^ sender, AddingNewEventArgs ^ e);

public delegate void AddingNewEventHandler(object? sender, AddingNewEventArgs e);

type AddingNewEventHandler = delegate of obj * AddingNewEventArgs -> unit

Public Delegate Sub AddingNewEventHandler(sender As Object, e As AddingNewEventArgs)

パラメーター

sender

Object

イベントのソース。通常は、データ コンテナーまたはデータ バインド コレクション。

e

AddingNewEventArgs

イベント データを格納している AddingNewEventArgs。

例

次のコード例では、 デリゲートを使用してイベントを AddingNewEventHandler 処理する方法を BindingSource.AddingNew 示します。 このコード例は、「方法: 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

注釈

イベントは BindingSource.AddingNew 、コレクションに新しい項目を追加する前に発生します。通常はデータ バインディングのシナリオで発生します。 このイベントのハンドラーは、追加する新しい項目を指定して、コレクション クラスの標準アクションをオーバーライドできます。 これは、 パラメーターeの AddingNewEventArgs プロパティをNewObjectこの新しい項目に設定することで実現されます。 通常、このアイテムは受信者のコレクションで予期される型である必要があります。または、コレクションは 型 InvalidCastExceptionの例外をスローします。

このイベントは、 や System.ComponentModel.BindingList<T>などのSystem.Windows.Forms.BindingSourceクラス内のデータ バインディング シナリオでよく使用されます。

AddingNewEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを指定します。 イベント ハンドラーにイベントを関連付けるには、イベントにデリゲートのインスタンスを追加します。 イベント ハンドラーは、デリゲートを削除しない限り、イベントが発生するたびに呼び出されます。 イベント ハンドラー デリゲートの詳細については、「イベントの 処理と発生」を参照してください。

拡張メソッド

GetMethodInfo(Delegate)

指定したデリゲートによって表されるメソッドを表すオブジェクトを取得します。

こちらもご覧ください

• AddingNewEventArgs
• BindingSource
• BindingList<T>