ICancelAddNew 接口

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

在向集合添加新项时添加事务性功能。

public interface class ICancelAddNew

public interface ICancelAddNew

type ICancelAddNew = interface

Public Interface ICancelAddNew

派生

System.ComponentModel.BindingList<T>

System.Windows.Forms.BindingSource

注解

接口 ICancelAddNew 使集合能够以可扩展方式添加新项。 随后可以提交或回滚新项。 集合 AddNew 的 方法用于暂定添加项，该项随后通过以下操作进行交易：

• EndNew 方法将显式提交挂起的添加。

• 执行另一个收集操作（例如插入、删除或移动）将隐式提交挂起的加法。

• 如果尚未提交挂起的加法，方法 CancelNew 将回滚该加法。

注意

在某些情况下，例如Windows 窗体复杂数据绑定，集合可能会接收CancelNew或EndNew调用新添加的项以外的项。 (每个项通常是数据视图中的一行。) 忽略这些调用;仅当指定了该项的索引时，才取消或提交新项。

有两种模型允许将项事务添加到数据绑定集合：

• 旧模型直接依赖于实现 IBindingList 接口的集合，并且直接使用 System.Windows.Forms.CurrencyManager 类进行数据绑定。 AddNew类的 System.Windows.Forms.CurrencyManager 、 EndCurrentEdit和 CancelCurrentEdit 方法负责为添加新项提供事务支持。 但是，此功能取决于通过 IEditableObject 接口支持事务行为的项。 如果项不支持此接口，则将始终将该项添加到列表中，而不考虑对 的后续调用 CancelCurrentEdit。

• 较新的模型通过实现 IBindingList 和 ICancelAddNew 接口的泛型BindingList<T>类支持更可靠的数据绑定方案。 在这种情况下，事务支持由 BindingList<T> 集合直接管理。

方法

CancelNew(Int32)	丢弃集合中挂起的新项。
EndNew(Int32)	向集合提交挂起的新项。

另请参阅

• IBindingList
• CurrencyManager
• IEditableObject
• BindingList<T>