IEditableCollectionView.AddNew Methode

public:
 System::Object ^ AddNew();

public object AddNew();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Gibt zurück

Das neue Element, das der Auflistung hinzugefügt wird.

Beispiele

Im folgenden Beispiel wird ein Window Element erstellt, das den Benutzer auffordert, ein neues Element hinzuzufügen. Anschließend wird AddNew aufgerufen, um ein neues Objekt zu erstellen und das DataContext Objekt auf dieses Window Objekt fest. Das gesamte Beispiel finden Sie unter Ändern einer Auflistung mithilfe des IEditableCollectionView-Beispiels.

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

Hinweise

Das Aufrufen AddNew beginnt mit einer Add-Transaktion. Sie sollten die Add-Transaktion aufrufen CommitNew oder CancelNew beenden. Ein neues Element wird immer in der Sammlungsansicht angezeigt. Alle Filter-, Sortier- oder Gruppierungsvorgänge, die auf die Ansicht angewendet werden, werden beim CommitNew Aufrufen auf das neue Element angewendet.