BindingSource.AddingNew 事件
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在将项添加到基础列表之前发生。
public:
event System::ComponentModel::AddingNewEventHandler ^ AddingNew;C#
public event System.ComponentModel.AddingNewEventHandler AddingNew;C#
public event System.ComponentModel.AddingNewEventHandler? AddingNew;member this.AddingNew : System.ComponentModel.AddingNewEventHandler Public Custom Event AddingNew As AddingNewEventHandler 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();
}
C#
// 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 方法。 有关处理事件的详细信息，请参阅 处理和引发事件。
| 产品 | 版本 |
|---|---|
| .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 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
