LinqDataSource.AutoGenerateOrderByClause Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

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.