IBindingList.AddNew 方法

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

将新项添加到列表。

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

返回

Object

添加到列表的项。

例外

NotSupportedException

AllowNew 为 false。

注解

仅当 为 时AllowNewtrue，才支持此方法;否则，NotSupportedException将引发 。

实现此方法意味着 IBindingList 列表必须了解要添加到列表的对象类型，并且必须了解如何创建该类型的新实例。 例如，如果有 对象的集合 myCustomer ，则 AddNew 方法应向列表中添加新 myCustomer 对象。

注意

如果此列表中的对象实现 IEditableObject 接口，则调用 CancelEdit 方法应放弃对象，而不是在使用 AddNew 方法创建对象时将其添加到列表中。 只有在调用 方法时， IEditableObject.EndEdit 才应将 对象添加到列表中。 因此，必须仔细同步对象和列表。

调用此方法时，应引发包含 ListChanged 相应索引的 ItemAdded 枚举的事件。 添加的行处于在控件上 DataGridView 按 Esc 可以删除新行的状态。 ListChanged再次在此行上引发具有 ItemAdded 枚举的事件表示该项现在是普通行， () 没有处于新状态。