LinqDataSource.OrderBy Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtient ou définit une valeur qui spécifie les champs utilisés pour classer les données récupérées.

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

Valeur de propriété

String

Chaîne utilisée pour créer la clause Order By.

Exemples

L’exemple suivant retourne des données dans l’ordre alphabétique inverse en fonction des valeurs de la Category propriété.

<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>

Remarques

Vous utilisez la OrderBy propriété pour spécifier les propriétés des données retournées à utiliser pour le tri. La propriété de tri des données doit exister dans la source de données d’origine, mais elle n’a pas à être incluse dans la Select propriété. Vous pouvez ajouter un espace et Ascending``ASC, ou Descending``DESC à une propriété dans la OrderBy chaîne afin de spécifier la façon dont les données ordonnées sont retournées.

Vous pouvez fournir plusieurs propriétés dans la OrderBy propriété en séparant chaque propriété à l’aide d’une virgule. Par exemple, pour commander par les propriétés nommées LastName et FirstName, définissez la OrderBy propriété sur « LastName, FirstName ».

Notes

Lorsque vous utilisez le LinqDataSource contrôle avec SQL Server 2000 ou SQL Server Compact 3.5 et que la AutoPage propriété est définie truesur , vous devez fournir une valeur dans la OrderBy propriété. Par défaut, la AutoPage propriété est true. Si vous attribuez une valeur à la Select propriété, vous devez également inclure toutes les colonnes d’identité dans la liste des propriétés retournées dans la requête.

Si la AutoSort propriété est définie sur true, un contrôle lié aux données peut passer une expression de tri au contrôle au moment de l’exécution LinqDataSource . Le LinqDataSource contrôle applique l’expression de tri du contrôle lié aux données après avoir appliqué la OrderBy propriété. Par conséquent, les données sont retournées en fonction de l’expression de tri du contrôle lié aux données.