ListCollectionView.AddNewItem Method

Adds the specified object to the collection.

Namespace:  System.Windows.Data
Assembly:  PresentationFramework (in PresentationFramework.dll)

abstract AddNewItem : 
        newItem:Object -> Object  
override AddNewItem : 
        newItem:Object -> Object

Parameters

newItem
Type: System.Object

The object to add to the collection.

Return Value

Type: System.Object
The object that was added to the collection.

Implements

IEditableCollectionViewAddNewItem.AddNewItem(Object)

ExceptionCondition
InvalidOperationException

An object cannot be added to the ListCollectionView by using the AddNewItem method.

Calling the AddNewItem method starts an add transaction. You should call the CommitNew or CancelNew methods 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.

.NET Framework

Supported in: 4.5, 4

.NET Framework Client Profile

Supported in: 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft