Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Interfaz ICancelAddNew

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

public interface ICancelAddNew

NombreDescripción
System_CAPS_pubmethodCancelNew(Int32)

Descarta un nuevo elemento pendiente de la colección.

System_CAPS_pubmethodEndNew(Int32)

Confirma un nuevo elemento pendiente en la colección.

El ICancelAddNew interfaz permite que una colección agregar un nuevo elemento de forma extensible. El nuevo elemento posteriormente se puede confirmar o revertir. El AddNew método de la colección se utiliza para agregar provisionalmente el elemento, que posteriormente se lleva a cabo a través de las siguientes operaciones:

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

  • Realizar otra operación de colección, como una inserción, eliminación o movimiento, se confirmará implícitamente la adición pendiente.

  • El CancelNew método deshará la inclusión pendiente si no se ya ha confirmado.

System_CAPS_noteNota

En algunos escenarios, como el enlace de datos complejo de formularios Windows Forms, la colección puede recibir CancelNew o EndNew llama a elementos que no sean el elemento recién agregado. (Cada elemento es normalmente una fila en una vista de datos.) Omita estas llamadas; cancele o confirme el nuevo elemento sólo si se especifica el índice del elemento.

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

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

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

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: