NotifyCollectionChangedEventArgs.NewItems Property

Gets the items affected by an action.

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

public IList NewItems { get; }

Property Value

Type: System.Collections.IList
The list of items affected by an action. The default is null.

In the existing Windows Phone 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 Windows Phone 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

null.

Replace

The newly added (replacing) item.

Reset

null.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2015 Microsoft