AddingNewEventHandler 代理人

定義

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

public delegate void AddingNewEventHandler(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)

參數

範例

下列程式碼範例示範如何使用 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) 加入至事件。 除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。 如需事件處理常式委派的詳細資訊，請參閱 處理和引發事件。

擴充方法

適用於

另請參閱

• AddingNewEventArgs
• BindingSource
• BindingList<T>