IEditableCollectionView.AddNew Метод

Определение

Пространство имен:

System.ComponentModel

Сборка:

WindowsBase.dll

Добавляет новый элемент в коллекцию.

public:
 System::Object ^ AddNew();

public object AddNew();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Возвращаемое значение

Object

Новый элемент, добавленный в коллекцию.

Примеры

В следующем примере создается запрос Window пользователя на добавление нового элемента. Затем он вызывает AddNew создание нового объекта и задает DataContextWindow объект для этого объекта. Полный пример см. в разделе "Изменение коллекции с помощью примера 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

Комментарии

Вызов AddNew начинает транзакцию добавления. Необходимо вызвать CommitNew или CancelNew завершить операцию добавления. Новый элемент всегда отображается в представлении коллекции. При вызове к новому элементу CommitNew применяется любая фильтрация, сортировка или группирование, применяемая к представлению.