IEditableCollectionView.AddNew Méthode

public:
 System::Object ^ AddNew();

public object AddNew();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Retours

Nouvel élément ajouté à la collection.

Exemples

L’exemple suivant crée un Window élément qui invite l’utilisateur à ajouter un nouvel élément. Ensuite, il appelle AddNew pour créer un objet et définit l’objet WindowDataContext sur cet objet. Pour l’ensemble de l’exemple, consultez Modification d’une collection à l’aide de l’exemple 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

Remarques

L’appel AddNew commence une transaction d’ajout. Vous devez appeler CommitNew ou CancelNew mettre fin à la transaction d’ajout. Un nouvel élément apparaît toujours dans la vue collection. Tout filtrage, tri ou regroupement appliqué à la vue est appliqué au nouvel élément lorsqu’il CommitNew est appelé.