ICancelAddNew Interfaz

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.TypeConverter.dll

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

System.ComponentModel.BindingList<T>

System.Windows.Forms.BindingSource

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:

• El modelo anterior se basa directamente en una colección que implementa la IBindingList interfaz y está enlazada directamente mediante la System.Windows.Forms.CurrencyManager clase . Los AddNewmétodos , EndCurrentEdity CancelCurrentEdit de la clase son responsables de la System.Windows.Forms.CurrencyManager compatibilidad transaccional para agregar nuevos elementos. Sin embargo, esta funcionalidad depende de los elementos que admiten el comportamiento transaccional a través de la IEditableObject interfaz . Si los elementos no admiten esta interfaz, el elemento siempre se agregará a la lista, independientemente de las llamadas posteriores a CancelCurrentEdit.

• El modelo más reciente admite un escenario de enlace de datos más sólido a través de la clase genérica BindingList<T> , que implementa las IBindingList interfaces y ICancelAddNew . En este caso, la colección administra directamente la BindingList<T> compatibilidad transaccional.

Métodos

CancelNew(Int32)	Descarta un nuevo elemento pendiente de la colección.
EndNew(Int32)	Confirma un nuevo elemento pendiente en la colección.

Consulte también

• IBindingList
• CurrencyManager
• IEditableObject
• BindingList<T>