CollectionView Class

Definition

Namespace:

System.Windows.Data

Assembly:

PresentationFramework.dll

Represents a view for grouping, sorting, filtering, and navigating a data collection.

public ref class CollectionView : System::Windows::Threading::DispatcherObject, System::Collections::IEnumerable, System::Collections::Specialized::INotifyCollectionChanged, System::ComponentModel::ICollectionView, System::ComponentModel::INotifyPropertyChanged

public class CollectionView : System.Windows.Threading.DispatcherObject, System.Collections.IEnumerable, System.Collections.Specialized.INotifyCollectionChanged, System.ComponentModel.ICollectionView, System.ComponentModel.INotifyPropertyChanged

type CollectionView = class
    inherit DispatcherObject
    interface IEnumerable
    interface INotifyCollectionChanged
    interface ICollectionView
    interface INotifyPropertyChanged

Public Class CollectionView
Inherits DispatcherObject
Implements ICollectionView, IEnumerable, INotifyCollectionChanged, INotifyPropertyChanged

Inheritance

Object

DispatcherObject

CollectionView

Derived

System.Windows.Controls.ItemCollection

System.Windows.Data.BindingListCollectionView

System.Windows.Data.ListCollectionView

Implements

IEnumerable INotifyCollectionChanged ICollectionView INotifyPropertyChanged

Remarks

You should not create objects of this class in your code. To create a collection view for a collection that only implements IEnumerable, create a CollectionViewSource object, add your collection to the Source property, and get the collection view from the View property.

You can think of a collection view as a layer on top of a binding source collection that allows you to navigate and display the collection based on sort, filter, and group queries, all without having to manipulate the underlying source collection itself. If the source collection implements the INotifyCollectionChanged interface, the changes that raise the CollectionChanged event are propagated to the views.

Because a view does not change the underlying source collection, a source collection can have multiple views associated with it. By using views, you can display the same data in different ways. For example, you can use two views on a collection of Task objects to show tasks sorted by priority on one part of the page and grouped by area on another part of the page.

In WPF applications, all collections have an associated default collection view. Rather than working with the collection directly, the binding engine always accesses the collection through the associated view. To get the default view, use the CollectionViewSource.GetDefaultView method. An internal class based on CollectionView is the default view for collections that implement only IEnumerable. ListCollectionView is the default view for collections that implement IList. BindingListCollectionView is the default view for collections that implement IBindingListView or IBindingList.

Alternatively, you can create a view of your collection in Extensible Application Markup Language (XAML) by using the CollectionViewSource class and then bind your control to that view. The CollectionViewSource class is the XAML representation of the CollectionView class. For an example, see How to: Sort and Group Data Using a View in XAML.

For more information, see "Binding to Collections" in Data Binding Overview.

To set a view in XAML, use the CollectionViewSource class. CollectionViewSource is the XAML representation of the CollectionView class, and it exposes the most commonly used members of the CollectionView class.

Constructors

CollectionView(IEnumerable)

Initializes a new instance of the CollectionView class that represents a view of the specified collection.

Properties

AllowsCrossThreadChanges	Gets a value that indicates whether a thread other than the one that created the CollectionView can change the SourceCollection.
CanFilter	Gets a value that indicates whether the view supports filtering.
CanGroup	Gets a value that indicates whether the view supports grouping.
CanSort	Gets a value that indicates whether the view supports sorting.
Comparer	Returns an object that you can use to compare items in the view.
Count	Gets the number of records in the view.
Culture	Gets or sets the culture information to use during sorting.
CurrentItem	Gets the current item in the view.
CurrentPosition	Gets the ordinal position of the CurrentItem within the (optionally sorted and filtered) view.
Dispatcher	Gets the Dispatcher this DispatcherObject is associated with. (Inherited from DispatcherObject)
Filter	Gets or sets a method used to determine if an item is suitable for inclusion in the view.
GroupDescriptions	Gets a collection of GroupDescription objects that describes how the items in the collection are grouped in the view.
Groups	Gets a collection of the top-level groups that is constructed based on the GroupDescriptions property.
IsCurrentAfterLast	Gets a value that indicates whether the CurrentItem of the view is beyond the end of the collection.
IsCurrentBeforeFirst	Gets a value that indicates whether the CurrentItem of the view is before the beginning of the collection.
IsCurrentInSync	Gets a value that indicates whether the CurrentItem is at the CurrentPosition.
IsDynamic	Gets a value that indicates whether the underlying collection provides change notifications.
IsEmpty	Gets a value that indicates whether the resulting (filtered) view is empty.
IsInUse	Gets a value that indicates whether any object is subscribing to the events of this CollectionView.
IsRefreshDeferred	Gets a value that indicates whether there is an outstanding DeferRefresh() in use.
NeedsRefresh	Gets a value that indicates whether the view needs to be refreshed.
NewItemPlaceholder	Gets the object that is in the collection to represent a new item.
SortDescriptions	Gets a collection of SortDescription structures that describes how the items in the collection are sorted in the view.
SourceCollection	Returns the underlying unfiltered collection.
UpdatedOutsideDispatcher	Gets a value that indicates whether it has been necessary to update the change log because a CollectionChanged notification has been received on a different thread without first entering the user interface (UI) thread dispatcher.

Methods

CheckAccess()	Determines whether the calling thread has access to this DispatcherObject. (Inherited from DispatcherObject)
ClearChangeLog()	Obsolete. Clears any pending changes from the change log.
ClearPendingChanges()	Clears unprocessed changed to the collection.
Contains(Object)	Returns a value that indicates whether the specified item belongs to the view.
DeferRefresh()	Enters a defer cycle that you can use to merge changes to the view and delay automatic refresh.
DetachFromSourceCollection()	Removes the reference to the underlying collection from the CollectionView.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetEnumerator()	Returns an object that you can use to enumerate the items in the view.
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetItemAt(Int32)	Retrieves the item at the specified zero-based index in the view.
GetType()	Gets the Type of the current instance. (Inherited from Object)
IndexOf(Object)	Returns the index at which the specified item is located.
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
MoveCurrentTo(Object)	Sets the specified item to be the CurrentItem in the view.
MoveCurrentToFirst()	Sets the first item in the view as the CurrentItem.
MoveCurrentToLast()	Sets the last item in the view as the CurrentItem.
MoveCurrentToNext()	Sets the item after the CurrentItem in the view as the CurrentItem.
MoveCurrentToPosition(Int32)	Sets the item at the specified index to be the CurrentItem in the view.
MoveCurrentToPrevious()	Sets the item before the CurrentItem in the view as the CurrentItem.
OKToChangeCurrent()	Returns a value that indicates whether the view can change which item is the CurrentItem.
OnAllowsCrossThreadChangesChanged()	Occurs when the AllowsCrossThreadChanges property changes.
OnBeginChangeLogging(NotifyCollectionChangedEventArgs)	Obsolete. Called by the base class to notify the derived class that an CollectionChanged event has been posted to the message queue.
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Raises the CollectionChanged event.
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)	Raises the CollectionChanged event.
OnCurrentChanged()	Raises the CurrentChanged event.
OnCurrentChanging()	Raises a CurrentChanging event that is not cancelable.
OnCurrentChanging(CurrentChangingEventArgs)	Raises the CurrentChanging event with the specified arguments.
OnPropertyChanged(PropertyChangedEventArgs)	Raises the PropertyChanged event using the specified arguments.
PassesFilter(Object)	Returns a value that indicates whether the specified item in the underlying collection belongs to the view.
ProcessCollectionChanged(NotifyCollectionChangedEventArgs)	When overridden in a derived class, processes a single change on the UI thread.
ProcessPendingChanges()	Ensures that all pending changes to the collection have been committed.
Refresh()	Re-creates the view.
RefreshOrDefer()	Refreshes the view or specifies that the view needs to be refreshed when the defer cycle completes.
RefreshOverride()	Re-creates the view.
SetCurrent(Object, Int32)	Sets the specified item and index as the values of the CurrentItem and CurrentPosition properties.
SetCurrent(Object, Int32, Int32)	Sets the specified item and index as the values of the CurrentItem and CurrentPosition properties. This method can be called from a constructor of a derived class.
ToString()	Returns a string that represents the current object. (Inherited from Object)
VerifyAccess()	Enforces that the calling thread has access to this DispatcherObject. (Inherited from DispatcherObject)

Events

CollectionChanged	Occurs when the view has changed.
CurrentChanged	Occurs after the CurrentItem has changed.
CurrentChanging	Occurs when the CurrentItem is changing.
PropertyChanged	Occurs when a property value has changed.

Explicit Interface Implementations

IEnumerable.GetEnumerator()	Returns an IEnumerator object that you can use to enumerate the items in the view.
INotifyCollectionChanged.CollectionChanged	Occurs when the view has changed.
INotifyPropertyChanged.PropertyChanged	Occurs when a property value changes.

Extension Methods