IEditableCollectionView.AddNew Método

public:
 System::Object ^ AddNew();

public object AddNew();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Devoluções

O novo item que é adicionado à coleção.

Exemplos

O exemplo seguinte cria um Window que incentiva o utilizador a adicionar um novo item. Depois, chama AddNew para criar um novo objeto e define o DataContext de Window para esse objeto. 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

A chamada AddNew inicia uma transação de adição. Deves ligar CommitNew ou CancelNew terminar a transação de adição. Um novo item aparece sempre na vista de coleção. Qualquer filtragem, ordenação ou agrupamento aplicado à vista é aplicado ao novo item quando CommitNew é chamado.