This documentation is archived and is not being maintained.

DataControlField::SortExpression Property

Gets or sets a sort expression that is used by a data source control to sort data.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[TypeConverterAttribute(L"System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public:
virtual property String^ SortExpression {
	String^ get ();
	void set (String^ value);
}

Property Value

Type: System::String
A sort expression that is used by a data source control to sort data. The default value is an empty string ("").

The OnFieldChanged method is called to raise a state change event when the SortExpression property is set.

The value of the SortExpression property is stored in view state. Controls such as the GridView control have a built-in sorting feature that automatically sets this property. This property is typically used only when you need to programmatically determine the column or columns being sorted or when you are adding your own custom sorting functionality to, for example, a GridView control.

When multiple columns are sorted, this property contains a comma-separated list of the fields by which to sort.

The following code example demonstrates how to use the SortExpression property to assign a sort expression to a data control field.

No code example is currently available or this language may not be supported.

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

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.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: