ICancelAddNew 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
向集合添加新项时添加事务功能。
public interface class ICancelAddNew
public interface ICancelAddNew
type ICancelAddNew = interface
Public Interface ICancelAddNew
- 派生
注解
该 ICancelAddNew 接口使集合能够以可扩展方式添加新项。 随后可以提交或回滚新项。 集合 AddNew 的方法用于暂定添加项,随后通过以下操作进行事务处理:
Note
在某些情况下,例如Windows 窗体复杂的数据绑定,集合可能会接收CancelNew或EndNew对新添加的项以外的项的调用。 (每个项通常是数据视图中的行。忽略这些调用;仅当指定该项的索引时,才取消或提交新项。
有两种模型允许将项事务性添加到数据绑定集合:
较旧的模型直接依赖于实现 IBindingList 接口的集合,并使用 System.Windows.Forms.CurrencyManager 类直接绑定数据。 AddNew、EndCurrentEdit 和 System.Windows.Forms.CurrencyManager 类的 CancelCurrentEdit > 方法负责对添加新项的事务支持。 但是,此功能取决于通过 IEditableObject 接口支持事务行为的项。 如果项不支持此接口,则无论后续调用 CancelCurrentEdit如何,项目都将始终添加到列表中。
较新的模型通过实现和ICancelAddNew接口的泛型BindingList<T>类IBindingList支持更可靠的数据绑定方案。 在这种情况下,事务支持由 BindingList<T> 集合直接管理。
方法
| 名称 | 说明 |
|---|---|
| CancelNew(Int32) |
放弃集合中挂起的新项。 |
| EndNew(Int32) |
将挂起的新项提交到集合。 |