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 事件。 此程式代碼範例是 How to： Customize Item Addition with the Windows Forms 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 新專案新增至集合之前，通常會在數據系結案例中發生此事件。 這個事件的處理程式可以提供要加入的新專案，覆寫集合類別的標準動作。 這可藉由將 NewObject 參數e的 AddingNewEventArgs 屬性設定為這個新專案來完成。 此專案通常必須是收件者集合所預期的類型，否則集合會擲回 類型的 InvalidCastException例外狀況。

此事件通常用於數據系結案例中，例如和System.ComponentModel.BindingList<T>的System.Windows.Forms.BindingSource類別。

當您建立 AddingNewEventHandler 委派 (Delegate) 時，就可以識別即將處理此事件的方法。 若要使事件與您的事件處理常式產生關聯，請將委派的執行個體 (Instance) 加入至事件。 除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。 如需事件處理程式委派的詳細資訊，請參閱 處理和引發事件。

擴充方法

GetMethodInfo(Delegate)

取得表示特定委派所代表之方法的物件。

另請參閱

• AddingNewEventArgs
• BindingSource
• BindingList<T>