EntityDataSource.OrderBy Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Obtient ou définit l’expression Entity SQL qui spécifie comment classer les résultats de la requête.

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

Clause ORDER BY.

Exemples

Le balisage XML dans l’exemple suivant, dans un fichier .aspx, récupère une valeur d’un contrôle et le transmet en tant que paramètre à la Where propriété.

<asp:EntityDataSource ID="SalesOrderHeader" runat="server"
  ConnectionString="name=AdventureWorksEntities"
  DefaultContainerName="AdventureWorksEntities" EnableDelete="True"
  EnableInsert="True" EnableUpdate="True" EntitySetName="SalesOrderHeader"
  EntityTypeFilter="" OrderBy="it.TotalDue DESC" Select=""
   Where="it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost">
  <WhereParameters>
    <asp:ControlParameter ControlID="costLimit" DbType="Int32"
      DefaultValue="2500" Name="ordercost" PropertyName="Text" />
  </WhereParameters>
</asp:EntityDataSource>

L’exemple XML précédent équivaut à ce qui onlineOrderssuit ObjectQuery<T> :

ObjectQuery<SalesOrderHeader> onlineOrders =
      context.SalesOrderHeader
       .Where("it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost",
         new ObjectParameter("ordercost", orderCost))
        .OrderBy("it.TotalDue DESC");

Remarques

La OrderBy propriété du EntityDataSource contrôle est une chaîne qui représente une expression ORDER BY d’une requête Entity SQL. Cette chaîne est passée, sans modification, à une ObjectQuery<T> chaîne exécutée par Entity Framework. Cette requête est la source des données réglementées par le EntityDataSource contrôle. La chaîne fournie à la OrderBy propriété utilise le même format que la chaîne passée à la OrderBy méthode de ObjectQuery<T>. Pour obtenir des exemples d’utilisation de la clause ORDER BY pour commander les résultats de la requête, consultez Comment : trier des données.