Compartir vía


ICancelAddNew Interfaz

Definición

Agrega funcionalidad transaccional al agregar un nuevo elemento a una colección.

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

Comentarios

La ICancelAddNew interfaz permite que una colección agregue un nuevo elemento de forma extensible. El nuevo elemento se puede confirmar o revertir posteriormente. El AddNew método de la colección se usa para agregar provisionalmente el elemento, que posteriormente se realiza mediante las siguientes operaciones:

  • El método EndNew confirmará explícitamente la adición pendiente.

  • La realización de otra operación de recopilación, como una inserción, eliminación o movimiento, confirmará implícitamente la adición pendiente.

  • El CancelNew método revertirá la adición pendiente si aún no se ha confirmado.

Nota

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

Hay dos modelos que permiten la adición transaccional de un elemento a una colección enlazada a datos:

Métodos

CancelNew(Int32)

Descarta un nuevo elemento pendiente de la colección.

EndNew(Int32)

Confirma un nuevo elemento pendiente en la colección.

Se aplica a

Consulte también