Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

IEditableCollectionView.AddNew Method

Adds a new item to the collection.

Namespace:  System.ComponentModel
Assembly:  WindowsBase (in WindowsBase.dll)

Object AddNew()

Return Value

Type: System.Object
The new item that is added to the collection.

Calling AddNew begins an add transaction. You should call CommitNew or CancelNew to end the add transaction. A new item always appears in the collection view. Any filtering, sorting, or grouping that is applied to the view is applied to the new item when CommitNew is called.

The following example creates a Window that prompts the user to add a new item. Then it calls AddNew to create a new object and sets the DataContext of the Window to that object. For the entire sample, see Changing a Collection by Using IEditableCollectionView Sample.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1, 3.0 SP2

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft