BindingList(T).ApplySortCore Method (System.ComponentModel)

.NET Framework Class Library

BindingList<(Of <(T>)>)..::.ApplySortCore Method

Sorts the items if overridden in a derived class; otherwise, throws a NotSupportedException.

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

Syntax

Visual Basic (Declaration)

Protected Overridable Sub ApplySortCore ( _
    prop As PropertyDescriptor, _
    direction As ListSortDirection _
)

Visual Basic (Usage)

Dim prop As PropertyDescriptor
Dim direction As ListSortDirection

Me.ApplySortCore(prop, direction)

protected virtual void ApplySortCore(
    PropertyDescriptor prop,
    ListSortDirection direction
)

Visual C++

protected:
virtual void ApplySortCore(
    PropertyDescriptor^ prop, 
    ListSortDirection direction
)

JScript

protected function ApplySortCore(
    prop : PropertyDescriptor, 
    direction : ListSortDirection
)

Parameters

prop: Type: System.ComponentModel..::.PropertyDescriptor
A PropertyDescriptor that specifies the property to sort on.

direction: Type: System.ComponentModel..::.ListSortDirection
One of the ListSortDirection values.

Exceptions

Exception	Condition
NotSupportedException	Method is not overridden in a derived class.

Remarks

The BindingList<(Of <(T>)>) class does not provide a base implementation of sorting, so ApplySortCore always throws a NotSupportedException by default. To enable sorting, derive from BindingList<(Of <(T>)>) and perform the following tasks:

Override ApplySortCore and implement sorting, raising the ListChanged event when sorting is complete.
Override RemoveSortCore and implement sort removal.
Override SupportsSortingCore and set SupportsSortingCore to true.

In addition, you may want to implement the supplemental SortDirectionCore and SortPropertyCore sorting properties.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

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

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

.NET Compact Framework

Supported in: 3.5, 2.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference

BindingList<(Of <(T>)>) Class

BindingList<(Of <(T>)>) Members

System.ComponentModel Namespace