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
返回值
添加到列表的项。
异常
异常类型 | 条件 |
---|---|
AllowNew 为 false。 |
备注
只有当 AllowNew 是 true 时才支持该方法,否则将引发 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