AddingNewEventHandler 代理人

定義

命名空間:

System.ComponentModel

組件:

netstandard.dll, System.ComponentModel.TypeConverter.dll

來源:

AddingNewEventHandler.cs

代表處理 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 A 包含事件資料。

範例

以下程式碼範例示範如何使用 AddingNewEventHandler 代理來處理 BindingSource.AddingNew 事件。 此程式碼範例是《 如何：用 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 事件發生在新增項目到集合之前，通常發生在資料綁定情境中。 此事件的處理者可以提供新要加入的項目，覆蓋集合類別的標準動作。 這是透過將參數e的屬性AddingNewEventArgs設定NewObject為這個新項目來實現的。 通常此項目必須符合接收集合預期的類型，否則集合會拋出一個異常類型 InvalidCastException。

此事件常用於資料綁定情境，包含System.Windows.Forms.BindingSourceSystem.ComponentModel.BindingList<T>類別如 和 。

當你建立 AddingNewEventHandler 代理人時，你就能確定處理事件的方法。 要將事件與你的事件處理器關聯，請將該代理的實例加入事件中。 事件處理程序會在事件發生時被呼叫，除非你移除代理。 欲了解更多關於事件處理代表的資訊，請參閱 「處理與提升事件」。

擴充方法

名稱	Description
GetMethodInfo(Delegate)	取得一個代表指定代理所代表方法的物件。

另請參閱

• AddingNewEventArgs
• BindingSource
• BindingList<T>