LinqDataSource.AutoGenerateOrderByClause Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob das LinqDataSource-Steuerelement basierend auf Werten in der OrderByParameters-Auflistung dynamisch eine Order By-Klausel erstellt.

public:
 property bool AutoGenerateOrderByClause { bool get(); void set(bool value); };

public bool AutoGenerateOrderByClause { get; set; }

member this.AutoGenerateOrderByClause : bool with get, set

Public Property AutoGenerateOrderByClause As Boolean

Eigenschaftswert

Boolean

true , wenn das LinqDataSource Steuerelement die Order By-Klausel erstellt, falseandernfalls . Der Standardwert ist false.

Beispiele

Das folgende Beispiel zeigt ein LinqDataSource -Steuerelement, das AutoGenerateOrderByClause auf truefestgelegt ist. In der OrderByParameters Auflistung ist ein Parameter enthalten, der die Daten basierend auf dem Eigenschaftennamen anordnet, den ein Benutzer aus einem DropDownList Steuerelement auswählt.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Hinweise

Wenn Sie die AutoGenerateOrderByClause -Eigenschaft auf truefestlegen, erstellt das LinqDataSource Steuerelement dynamisch eine Order By-Klausel, die auf den Werten in der OrderByParameters Auflistung basiert. Das LinqDataSource -Steuerelement sortiert die Daten nach dem ersten Parameter und sortiert dann zusätzlich die Daten für jeden zusätzlichen Parameter. Parameter, die oder einen leeren Wert enthalten null , sind nicht in der Order By-Klausel enthalten.

Sie legen die OrderBy -Eigenschaft nicht fest, wenn auf AutoGenerateOrderByClausetruefestgelegt ist, da der Parser dynamisch die Order By-Klausel erstellt. Das LinqDataSource Steuerelement löst eine Ausnahme aus, wenn auf AutoGenerateOrderByClausetrue festgelegt ist und der OrderBy -Eigenschaft Werte zugewiesen werden.

Gilt für:

Freigeben über