使用英语阅读

通过


ICancelAddNew 接口

定义

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

public interface ICancelAddNew
派生

注解

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

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

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

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

备注

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

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

方法

CancelNew(Int32)

丢弃集合中挂起的新项。

EndNew(Int32)

向集合提交挂起的新项。

适用于

产品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

另请参阅