EntityDataSource.OrderBy Propriété

  • Référence

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 la manière de 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 à partir d’un contrôle et la 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 est équivalent au suivant ObjectQuery<T> nommé onlineOrders:

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, à un ObjectQuery<T> qui est exécuté 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 classer les résultats d’une requête, consultez How to: Sort Data.

S’applique à