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 Forms 複雜的數據系結，集合可能會收到CancelNew或EndNew呼叫新增專案以外的專案。 (每個專案通常是數據檢視中的數據列。) 忽略這些呼叫;只有在指定該專案的索引時，才會取消或認可新專案。

有兩個模型允許將專案交易新增至數據系結集合：

• 較舊的模型會直接依賴實作 介面的 IBindingList 集合，並使用 類別直接系 System.Windows.Forms.CurrencyManager 結數據。 類別AddNew的 System.Windows.Forms.CurrencyManager 、 EndCurrentEdit和 CancelCurrentEdit 方法負責新增專案的交易式支援。 不過，這項功能取決於透過 IEditableObject 介面支援交易行為的專案。 如果專案不支援此介面，則不論後續對的呼叫 CancelCurrentEdit為何，專案一律會新增至清單。

• 較新的模型透過實作 和 ICancelAddNew 介面的泛型BindingList<T>類別，IBindingList支援更健全的數據系結案例。 在此情況下，交易式支援是由集合直接管理 BindingList<T> 。

方法

CancelNew(Int32)	從集合中捨棄暫止的新項目。
EndNew(Int32)	將暫止的新項目認可到集合中。

另請參閱

• IBindingList
• CurrencyManager
• IEditableObject
• BindingList<T>