IBindingList.AddNew 方法

将新项添加到列表。

**命名空间:**System.ComponentModel
**程序集:**System(在 system.dll 中)

语法

声明
Function AddNew As Object
用法
Dim instance As IBindingList
Dim returnValue As Object

returnValue = instance.AddNew
Object AddNew ()
Object^ AddNew ()
Object AddNew ()
function AddNew () : Object

返回值

添加到列表的项。

异常

异常类型 条件

NotSupportedException

AllowNewfalse

备注

只有当 AllowNewtrue 时才支持该方法,否则将引发 NotSupportedException

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

提示

如果列表中的对象实现 IEditableObject 接口,则当使用 AddNew 方法创建对象时,调用 CancelEdit 方法应该丢弃对象,而不是将其添加到列表中。只有当调用 IEditableObject.EndEdit 方法时,才将该对象添加到列表中。因此,您必须小心地同步对象和列表。

当调用此方法时,应该用带有适当索引的 ItemAdded 枚举引发 ListChanged 事件。添加的行正处于这样一种状态,此时在 DataGridView 控件上点击 Esc 键可将新行移除。在此行上再次用 ItemAdded 枚举引发 ListChanged 事件指示该项现在是普通行(不处于新状态)。

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:2.0、1.0

请参见

参考

IBindingList 接口
IBindingList 成员
System.ComponentModel 命名空间