BindingSource.AddingNew 事件

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

BindingSource.cs

在将项添加到基础列表之前发生。

public:
 event System::ComponentModel::AddingNewEventHandler ^ AddingNew;

public event System.ComponentModel.AddingNewEventHandler? AddingNew;

member this.AddingNew : System.ComponentModel.AddingNewEventHandler 

Public Custom Event AddingNew As AddingNewEventHandler 

事件类型

AddingNewEventHandler

例外

InvalidOperationException

NewObject 与该列表中包含的类型不属于同一类型。

示例

下面的代码示例使用 BindingSource 组件将列表绑定到 DataGridView 控件。 事件处理程序将新项添加到列表中 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

注解

在 AddingNew 将新对象添加到由 属性表示的基础列表之前，发生该 List 事件。 在调用 方法之后 AddNew ，但在创建新项并将其添加到基础列表之前触发此事件。 通过处理此事件，程序员可以提供自定义项创建和插入行为，而无需强制从 BindingSource 类派生。 这是通过在事件处理程序中通过将 参数的 System.ComponentModel.AddingNewEventArgs 属性设置为NewObject新项来实现的。 在 事件中创建 AddingNew 的新对象的类型必须与列表中包含的类型相同，否则将发生异常。 当绑定到 或 DataTable 时，无法设置 NewObject 属性，DataView因为无法向列表中添加新DataRowView的 。

有关提供自定义新项功能的详细信息，请参阅 AddNew 方法。 有关处理事件的详细信息，请参阅 处理和引发事件。

另请参阅

• AddNew()
• OnAddingNew(AddingNewEventArgs)
• AddingNewEventArgs