AddingNewEventHandler 代理人
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示處理 AddingNew 事件的方法。
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 -> unitPublic Delegate Sub AddingNewEventHandler(sender As Object, e As AddingNewEventArgs)- sender
- Object
事件的來源，通常為資料容器或資料繫結集合。
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) 加入至事件。 除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。 如需事件處理程式委派的詳細資訊，請參閱 處理和引發事件。
|
Get |
取得表示特定委派所代表之方法的物件。 |
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
