ICancelAddNew ICancelAddNew ICancelAddNew ICancelAddNew Interface

Definición

Agrega funcionalidad transaccional al agregar un nuevo elemento a una colección.Adds transactional capability when adding a new item to a collection.

public interface class ICancelAddNew
public interface ICancelAddNew
type ICancelAddNew = interface
Public Interface ICancelAddNew
Derivado

Comentarios

La ICancelAddNew interfaz permite a una colección agregar un nuevo elemento de forma extensible.The ICancelAddNew interface enables a collection to add a new item in an extensible way. Posteriormente, el nuevo elemento se puede confirmar o revertir.The new item subsequently can be committed or rolled back. El AddNew método de la colección se usa para agregar provisionalmente el elemento, que se pasa posteriormente a través de las operaciones siguientes:The AddNew method of the collection is used to tentatively add the item, which is subsequently transacted through the following operations:

  • El EndNew método confirma explícitamente la adición pendiente.The EndNew method will explicitly commit the pending addition.

  • Al realizar otra operación de recopilación, como una inserción, eliminación o movimiento, se confirma implícitamente la adición pendiente.Performing another collection operation, such as an insertion, removal, or move will implicitly commit the pending addition.

  • El CancelNew método revertirá la adición pendiente si aún no se ha confirmado.The CancelNew method will roll back the pending addition if it has not already been committed.

Nota

En algunos escenarios, como Windows Forms enlace de datos complejo, la colección puede recibir CancelNew o EndNew llamar a elementos distintos del elemento recién agregado.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. (Cada elemento suele ser una fila en una vista de datos). Omitir estas llamadas; cancele o confirme el nuevo elemento solo cuando se especifique el índice de ese elemento.(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.

Hay dos modelos que permiten la adición transaccional de un elemento a una colección enlazada a datos:There are two models that allow transactional addition of an item to a data-bound collection:

Métodos

CancelNew(Int32) CancelNew(Int32) CancelNew(Int32) CancelNew(Int32)

Descarta un nuevo elemento pendiente de la colección.Discards a pending new item from the collection.

EndNew(Int32) EndNew(Int32) EndNew(Int32) EndNew(Int32)

Confirma un nuevo elemento pendiente en la colección.Commits a pending new item to the collection.

Se aplica a

Consulte también: