IEditableCollectionView.AddNew Methode

Referenz

Definition

Namespace:: System.ComponentModel

Assembly:: WindowsBase.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der Auflistung ein neues Element hinzu.

public:
 System::Object ^ AddNew();

public object AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Gibt zurück

Object

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

Beispiele

Im folgenden Beispiel wird eine Window erstellt, die den Benutzer auffordert, ein neues Element hinzuzufügen. Dann wird aufgerufen AddNew , um ein neues Objekt zu erstellen, und legt das DataContext von Window auf dieses Objekt fest. Das gesamte Beispiel finden Sie unter Ändern einer Sammlung mithilfe von IEditableCollectionView-Beispiel.

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();
}

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

Beim Aufrufen AddNew wird eine Add-Transaktion gestartet. Sie sollten die Transaktion hinzufügen aufrufen CommitNew oder CancelNew beenden. In der Auflistungsansicht wird immer ein neues Element angezeigt. Alle Filter-, Sortier- oder Gruppierungen, die auf die Ansicht angewendet werden, werden beim CommitNew Aufruf auf das neue Element angewendet.

Gilt für:

Produkt	Versionen
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Teilen über