IEditableCollectionView Interface

Definição

public interface class IEditableCollectionView

public interface IEditableCollectionView

type IEditableCollectionView = interface

Public Interface IEditableCollectionView

Derivado

System.ComponentModel.IEditableCollectionViewAddNewItem

System.Windows.Controls.ItemCollection

System.Windows.Data.BindingListCollectionView

System.Windows.Data.ListCollectionView

Exemplos

O exemplo seguinte mostra como adicionar um item a uma coleção usando métodos definidos por IEditableCollectionView. Esta aplicação apresenta uma lista de artigos à venda e dá ao utilizador a opção de adicionar, editar ou remover um item. Quando o utilizador adiciona ou edita um item, um formulário pede-lhe que insira um novo item. Se o utilizador submeter o formulário, o item é comprometido para a coleção. Se o utilizador cancelar o formulário, o item é descartado. Para a amostra completa, veja Alterar uma Coleção Usando a Amostra IEditableCollectionView.

IEditableCollectionView editableCollectionView =
    itemsControl.Items;

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()
{
    //Create a new item to be added to the collection.
    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();
}

Dim editableCollectionView As IEditableCollectionView = TryCast(itemsControl.Items, IEditableCollectionView)

If Not editableCollectionView.CanAddNew Then
    MessageBox.Show("You cannot add items to the list.")
    Return
End If

' Create a window that prompts the user to enter a new
' item to sell.
Dim win As 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 CBool(win.ShowDialog()) Then
    editableCollectionView.CommitNew()
Else
    editableCollectionView.CancelNew()
End If

Observações

Quando uma vista de coleção implementa a IEditableCollectionView interface, pode alterar diretamente a coleção subjacente, se permitir alterações, usando os métodos e propriedades que IEditableCollectionView expõem, independentemente do tipo da coleção.

Os tipos ItemCollection, BindingListCollectionView e ListCollectionView são os tipos que vêm com Windows Presentation Foundation (WPF) que herdam de CollectionView. Estes tipos também implementam o IEditableCollectionView, por isso podes editar uma coleção que use um desses tipos. ItemCollection, em particular, é frequentemente usado porque a ItemsControl.Items propriedade é um ItemCollection.