LinqDataSource.OrderBy Свойство

Определение

Возвращает или задает значение, определяющее поля, используемые для сортировки полученных данных.Gets or sets a value that specifies which fields are used for ordering the retrieved data.

public:
 property System::String ^ OrderBy { System::String ^ get(); void set(System::String ^ value); };
public string OrderBy { get; set; }
member this.OrderBy : string with get, set
Public Property OrderBy As String

Значение свойства

Строка, используемая для создания предложения ORDER BY.A string that is used to create the Order By clause.

Примеры

В следующем примере данные возвращаются в алфавитном порядке на основе значений в свойстве Category.The following example returns data in reverse alphabetical order based on values in the Category property.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    OrderBy="Category Descending"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    OrderBy="Category Descending"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Комментарии

Используйте свойство OrderBy, чтобы указать, какие свойства из возвращаемых данных следует использовать для сортировки.You use the OrderBy property to specify which properties from the returned data to use for sorting. Свойство для сортировки данных должно существовать в исходном источнике данных, но не обязательно включать в свойство Select.The property for sorting the data must exist in the original data source, but it does not have to be included in the Select property. Можно добавить пробел и Ascending, ASC, Descendingили DESC в свойство в строке OrderBy, чтобы указать способ возврата упорядоченных данных.You can add a space and Ascending, ASC, Descending, or DESC to a property in the OrderBy string in order to specify how the ordered data is returned.

Можно предоставить несколько свойств в свойстве OrderBy, разделив каждое свойство с помощью запятой.You can provide more than one property in the OrderBy property by separating each property by using a comma. Например, чтобы упорядочить по свойствам с именами LastName и FirstName, задайте для свойства OrderBy значение "LastName, FirstName".For example, to order by properties named LastName and FirstName, set the OrderBy property to "LastName, FirstName".

Примечание

При использовании элемента управления LinqDataSource с SQL Server 2000SQL Server 2000 или SQL Server Compact 3,5SQL Server Compact 3.5 а свойством AutoPagetrue, необходимо указать значение в свойстве OrderBy.When you use the LinqDataSource control with SQL Server 2000SQL Server 2000 or SQL Server Compact 3,5SQL Server Compact 3.5 and the AutoPage property is set to true, you must provide a value in the OrderBy property. По умолчанию свойство AutoPage true.By default, the AutoPage property is true. Если присвоить значение свойству Select, необходимо также включить все столбцы идентификаторов в список свойств, возвращаемых в запросе.If you assign a value to the Select property, you must also include all identity columns in the list of properties that is returned in the query.

Если свойство AutoSort имеет значение true, то элемент управления с привязкой к данным может передать выражение сортировки элементу управления LinqDataSource во время выполнения.If the AutoSort property is set to true, a data-bound control can pass a sort expression to the LinqDataSource control at run time. Элемент управления LinqDataSource будет применять выражение сортировки из элемента управления с привязкой к данным после того, как он применяет свойство OrderBy.The LinqDataSource control will apply the sort expression from the data-bound control after it applies the OrderBy property. Таким образом, данные возвращаются в соответствии с выражением сортировки элемента управления с привязкой к данным.Therefore, the data is returned according to the sort expression from the data-bound control.

Применяется к