Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ICollectionViewLiveShaping Interface

.NET Framework 4.5

Defines properties that enables sorting, grouping, and filtering on a CollectionView in real time.

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

public interface ICollectionViewLiveShaping

The ICollectionViewLiveShaping type exposes the following members.

  NameDescription
Public propertyCanChangeLiveFilteringGets a value that indicates whether the collection view supports turning filtering data in real time on or off.
Public propertyCanChangeLiveGroupingGets a value that indicates whether the collection view supports turning grouping data in real time on or off.
Public propertyCanChangeLiveSortingGets a value that indicates whether the collection view supports turning sorting data in real time on or off.
Public propertyIsLiveFilteringGets or sets a value that indicates whether filtering data in real time is enabled.
Public propertyIsLiveGroupingGets or sets a value that indicates whether grouping data in real time is enabled.
Public propertyIsLiveSortingGets or sets a value that indicates whether sorting in real time is enabled.
Public propertyLiveFilteringPropertiesGets a collection of strings that specify the properties that participate in filtering data in real time.
Public propertyLiveGroupingPropertiesGets a collection of strings that specify the properties that participate in grouping data in real time.
Public propertyLiveSortingPropertiesGets a collection of strings that specify the properties that participate in sorting data in real time.
Top

When live sorting, grouping, or filtering is enabled, a CollectionView will rearrange the position of data in the CollectionView when the data is modified. For example, suppose that an application uses a DataGrid to list stocks in a stock market and the stocks are sorted by stock value. If live sorting is enabled on the stocks' CollectionView, a stock's position in the DataGrid moves when the value of the stock becomes greater or less than another stock's value.

The ListCollectionView, BindingListCollectionView, and ItemCollection classes implement the ICollectionViewLiveShaping interface. The CollectionViewSource class also implements the properties defined by ICollectionViewLiveShaping to enable setting the properties in XAML.

Notes for Inheritors

Implement this interface on your custom CollectionView to support sorting, grouping, and filtering data in real time. Your CollectionView can implement the sorting, grouping, and filtering operations itself, or you can delegate one or more of them to another object, such as the underlying collection. If you delegate the shaping operations, the CollectionView might not have control over whether live shaping is enabled. Your CollectionView must accept the behavior of the object to which it delegates. In this case, set the appropriate CanChange* properties to false. If your CollectionView knows whether the delegate object supports live shaping, it can set the appropriate IsLive* properties to the known value. Otherwise, the CollectionView should set the IsLive* properties to null.

.NET Framework

Supported in: 4.5

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.

Show:
© 2014 Microsoft