NotifyCollectionChangedEventArgs.NewItems Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets the items affected by an action.

Namespace:  System.Collections.Specialized
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
Public ReadOnly Property NewItems As IList
public IList NewItems { get; }

Property Value

Type: System.Collections.IList
The list of items affected by an action. The default is nulla null reference (Nothing in Visual Basic).

Remarks

In the existing Silverlight implementation, INotifyCollectionChanged is always used for single item changes. Because of the NotifyCollectionChangedEventArgs constructor signatures, it is not possible to raise CollectionChanged in such a way that it reports multiple items.

The type of this property is IList for compatibility, but in the existing Silverlight implementation you can generally assume that the IList only contains one item. To get that item you could use the C# shorthand of collectionChangedEventArgs.NewItems[0].

NewItems will contain the following depending on the Action being reported in the event data:

Action

Add contains:

Add

The newly added item.

Remove

nulla null reference (Nothing in Visual Basic).

Replace

The newly added (replacing) item.

Reset

nulla null reference (Nothing in Visual Basic).

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.