Adds transactional capability when adding a new item to a collection.

See Also: ICancelAddNew Members


public interface ICancelAddNew


The System.ComponentModel.ICancelAddNew interface enables a collection to add a new item in an extensible way. The new item subsequently can be committed or rolled back. The IBindingList.AddNew method of the collection is used to tentatively add the item, which is subsequently transacted through the following operations:


In some scenarios, such as Windows Forms complex data binding, the collection may receive ICancelAddNew.CancelNew(int) or ICancelAddNew.EndNew(int) calls for items other than the newly added item. (Each item is typically a row in a data view.) Ignore these calls; cancel or commit the new item only when that item's index is specified.

There are two models that allow transactional addition of an item to a data-bound collection:


Namespace: System.ComponentModel
Assembly: System (in System.dll)
Assembly Versions:,