ICancelAddNew Интерфейс

Определение

Добавляет поддержку транзакций при добавлении нового элемента в коллекцию.Adds transactional capability when adding a new item to a collection.

public interface class ICancelAddNew
public interface ICancelAddNew
type ICancelAddNew = interface
Public Interface ICancelAddNew
Производный

Комментарии

ICancelAddNewИнтерфейс позволяет коллекции добавлять новый элемент расширяемым способом.The ICancelAddNew interface enables a collection to add a new item in an extensible way. Впоследствии новый элемент можно будет зафиксировать или откатить.The new item subsequently can be committed or rolled back. AddNewМетод коллекции используется для предварительной установки элемента, который затем передается с помощью следующих операций:The AddNew method of the collection is used to tentatively add the item, which is subsequently transacted through the following operations:

  • EndNewМетод явно зафиксирует ожидающее добавление.The EndNew method will explicitly commit the pending addition.

  • Выполнение другой операции сбора, например вставки, удаления или перемещения, неявно фиксирует ожидающее добавление.Performing another collection operation, such as an insertion, removal, or move will implicitly commit the pending addition.

  • CancelNewМетод будет выполнять откат ожидающего добавления, если он еще не был зафиксирован.The CancelNew method will roll back the pending addition if it has not already been committed.

Примечание

В некоторых сценариях, таких как Windows Forms сложная привязка данных, коллекция может получить CancelNew или EndNew вызвать другие элементы, кроме вновь добавленного элемента.In some scenarios, such as Windows Forms complex data binding, the collection may receive CancelNew or EndNew 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:

  • Старая модель полагается непосредственно на коллекцию, которая реализует IBindingList интерфейс и привязана к данным непосредственно с помощью System.Windows.Forms.CurrencyManager класса.The older model relies directly on a collection that implements the IBindingList interface and is data-bound directly using the System.Windows.Forms.CurrencyManager class. AddNewМетоды, EndCurrentEdit и CancelCurrentEdit System.Windows.Forms.CurrencyManager класса отвечают за поддержку транзакций для добавления новых элементов.The AddNew, EndCurrentEdit, and CancelCurrentEdit methods of the System.Windows.Forms.CurrencyManager class are responsible for transactional support for adding new items. Однако эта функциональность зависит от элементов, поддерживающих транзакционное поведение через IEditableObject интерфейс.However, this functionality depends upon the items supporting transactional behavior through the IEditableObject interface. Если элементы не поддерживают этот интерфейс, элемент всегда будет добавлен в список, независимо от последующих вызовов CancelCurrentEdit .If the items do not support this interface, the item will always be added to the list, regardless of subsequent calls to CancelCurrentEdit.

  • Новая модель поддерживает более надежный сценарий привязки данных через универсальный BindingList<T> класс, который реализует IBindingList ICancelAddNew интерфейсы и.The newer model supports a more robust data-binding scenario through the generic BindingList<T> class, which implements the IBindingList and ICancelAddNew interfaces. В этом случае транзакционная поддержка управляется BindingList<T> непосредственно коллекцией.In this case, the transactional support is managed by the BindingList<T> collection directly.

Методы

CancelNew(Int32)

Удаляет незафиксированный новый элемент из коллекции.Discards a pending new item from the collection.

EndNew(Int32)

Фиксирует незафиксированный новый элемент в коллекции.Commits a pending new item to the collection.

Применяется к

См. также раздел