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 窗体 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 委托时，需要标识将要处理该事件的方法。 若要将事件与事件处理程序关联，请将该委托的一个实例添加到事件中。 除非移除了该委托，否则每当发生该事件时就会调用事件处理程序。 有关事件处理程序委托的详细信息，请参阅 处理和引发事件。

扩展方法

GetMethodInfo(Delegate)

获取指示指定委托表示的方法的对象。

另请参阅

• AddingNewEventArgs
• BindingSource
• BindingList<T>