EntityDataSource.OrderBy Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ruft den Entity SQL-Ausdruck ab, der angibt, wie die Abfrageergebnisse sortiert werden sollen, oder legt diesen fest.

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

Eigenschaftswert

String

Die ORDER BY-Klausel.

Beispiele

Das XML-Markup im folgenden Beispiel in einer ASPX-Datei ruft einen Wert aus einem Steuerelement ab und übergibt ihn als Parameter an die Where -Eigenschaft.

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

Das vorherige XML-Beispiel entspricht folgendem ObjectQuery<T> Namen onlineOrders:

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

Hinweise

Die OrderBy -Eigenschaft des EntityDataSource Steuerelements ist eine Zeichenfolge, die einen ORDER BY-Ausdruck einer Entity SQL-Abfrage darstellt. Diese Zeichenfolge wird ohne Änderung an ein ObjectQuery<T> übergeben, das vom Entity Framework ausgeführt wird. Diese Abfrage ist die Quelle der Daten, die durch das EntityDataSource -Steuerelement reguliert werden. Die für die OrderBy -Eigenschaft bereitgestellte Zeichenfolge verwendet das gleiche Format wie die Zeichenfolge, die an die OrderBy -Methode von ObjectQuery<T>übergeben wird. Beispiele für die Verwendung der ORDER BY-Klausel zum Sortieren von Abfrageergebnissen finden Sie unter Vorgehensweise: Sortieren von Daten.