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 IEditableCollectionView

 

Publicado: octubre de 2016

Define métodos y propiedades que CollectionView implementa para ofrecer capacidades de edición a una colección.

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

public interface IEditableCollectionView

NombreDescripción
System_CAPS_pubpropertyCanAddNew

Obtiene un valor que indica si puede agregarse un elemento nuevo a la colección.

System_CAPS_pubpropertyCanCancelEdit

Obtiene un valor que indica si la vista de colección puede descartar los cambios pendientes y restaurar los valores originales de un objeto editado.

System_CAPS_pubpropertyCanRemove

Obtiene un valor que indica si un elemento puede quitarse de la colección.

System_CAPS_pubpropertyCurrentAddItem

Obtiene el elemento que se está agregando durante la transacción de adición actual.

System_CAPS_pubpropertyCurrentEditItem

Obtiene el elemento de la colección que se está editando.

System_CAPS_pubpropertyIsAddingNew

Obtiene un valor que indica si hay una transacción de adición en curso.

System_CAPS_pubpropertyIsEditingItem

Obtiene un valor que indica si hay una transacción de edición en curso.

System_CAPS_pubpropertyNewItemPlaceholderPosition

Obtiene o establece la posición del nuevo marcador de posición de elemento en la vista de colección.

NombreDescripción
System_CAPS_pubmethodAddNew()

Agrega un nuevo elemento a la colección.

System_CAPS_pubmethodCancelEdit()

Finaliza la transacción de edición y, si es posible, restaura el valor original del elemento.

System_CAPS_pubmethodCancelNew()

Finaliza la transacción de adición y descarta el nuevo elemento pendiente.

System_CAPS_pubmethodCommitEdit()

Finaliza la transacción de edición y guarda los cambios pendientes.

System_CAPS_pubmethodCommitNew()

Finaliza la transacción de adición y guarda el nuevo elemento pendiente.

System_CAPS_pubmethodEditItem(Object)

Inicia una transacción de edición del elemento especificado.

System_CAPS_pubmethodRemove(Object)

Quita el elemento especificado de la colección.

System_CAPS_pubmethodRemoveAt(Int32)

Quita de la colección un elemento situado en la posición especificada.

Cuando una vista de colección implementa la IEditableCollectionView interfaz, puede modificar directamente la colección subyacente, si permite cambios que se realizan utilizando los métodos y propiedades que IEditableCollectionView expone, independientemente del tipo de la colección.

Los tipos ItemCollection, BindingListCollectionView, y ListCollectionView son los tipos que se suministran con Windows Presentation Foundation (WPF) que heredan de CollectionView. Estos tipos también implementan la IEditableCollectionView, para que pueda modificar una colección que usa uno de esos tipos. ItemCollection, en particular, a menudo se utiliza porque el ItemsControl.Items propiedad es una ItemCollection.

En el ejemplo siguiente se muestra cómo agregar un elemento a una colección mediante los métodos que se definen mediante IEditableCollectionView. Esta aplicación muestra una lista de artículos en venta y ofrece al usuario la opción de agregar, modificar o quitar un elemento. Cuando el usuario agrega o edita un elemento, un formulario pide al usuario que escriba un nuevo elemento. Si el usuario envía el formulario, el elemento se confirma en la colección. Si el usuario cancela el formulario, se descarta el elemento. Para obtener el ejemplo completo, vea Changing a Collection by Using IEditableCollectionView Sample.

IEditableCollectionView editableCollectionView = 
    itemsControl.Items as IEditableCollectionView; 

if (!editableCollectionView.CanAddNew)
{
    MessageBox.Show("You cannot add items to the list.");
    return;
}

// Create a window that prompts the user to enter a new
// item to sell.
ChangeItemWindow win = new ChangeItemWindow();

//Create a new item to be added to the collection.
win.DataContext = editableCollectionView.AddNew();

// If the user submits the new item, commit the new
// object to the collection.  If the user cancels 
// adding the new item, discard the new item.
if ((bool)win.ShowDialog())
{
    editableCollectionView.CommitNew();
}
else
{
    editableCollectionView.CancelNew();
}

.NET Framework
Disponible desde 3.0
Silverlight
Disponible desde 3.0
Windows Phone Silverlight
Disponible desde 7.1
Volver al principio
Mostrar: