ICancelAddNew Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega funcionalidad transaccional al agregar un nuevo elemento a una colección.
public interface class ICancelAddNewpublic interface ICancelAddNewtype ICancelAddNew = interfacePublic 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:
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. |
