IEditableCollectionView.AddNew Metoda

public:
 System::Object ^ AddNew();

public object AddNew();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Zwraca

Nowy element dodany do kolekcji.

Przykłady

Poniższy przykład tworzy obiekt Window , który monituje użytkownika o dodanie nowego elementu. Następnie wywołuje AddNew polecenie , aby utworzyć nowy obiekt i ustawia DataContextWindow obiekt na ten obiekt. W całym przykładzie zobacz Zmienianie kolekcji przy użyciu przykładu 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

Uwagi

Wywołanie AddNew rozpoczyna dodawanie transakcji. Należy wywołać CommitNew lub CancelNew zakończyć dodawanie transakcji. Nowy element jest zawsze wyświetlany w widoku kolekcji. Każde filtrowanie, sortowanie lub grupowanie stosowane do widoku jest stosowane do nowego elementu po CommitNew wywołaniu.