EntityDataSource.AutoGenerateOrderByClause Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ruft einen Wert ab, der angibt, ob das EntityDataSource-Steuerelement basierend auf Werten in der OrderByParameters-Sammlung 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 EntityDataSource-Steuerelement die ORDER BY-Klausel erstellt, andernfalls false. Der Standardwert ist false.

Ausnahmen

InvalidOperationException

Wenn die AutoGenerateOrderByClause-Eigenschaft auf true festgelegt und die OrderBy-Eigenschaft nicht NULL ist.

Beispiele

Im folgenden Beispiel wird automatisch die ORDER BY-Klausel generiert und der Wert von verwendet, OrderByDropDownList um den Wert des Parameters festzulegen.

<asp:DropDownList AutoPostBack="true" ID="OrderByDropDownList" runat="server">
    <asp:ListItem Value="TotalDue"></asp:ListItem>
    <asp:ListItem Value="OrderDate"></asp:ListItem>
</asp:DropDownList>

<asp:EntityDataSource ID="EntityDataSourceWithAutoGenOrderBy" runat="server"
ConnectionString="name=AdventureWorksEntities"
DefaultContainerName="AdventureWorksEntities"
EntitySetName="SalesOrderHeaders"
Select="it.SalesOrderID, it.TotalDue, it.OrderDate"
AutoGenerateOrderByClause="True">
<OrderByParameters>
    <asp:ControlParameter
    ControlID="OrderByDropDownList"/>
</OrderByParameters>
</asp:EntityDataSource>

Im folgenden Beispiel wird automatisch die ORDER BY-Klausel generiert und das DefaultValue -Attribut des Parameter Elements verwendet, um den Wert des Parameters festzulegen.

<asp:EntityDataSource ID="EntityDataSourceWithAutoGenOrderBy" runat="server"
ConnectionString="name=AdventureWorksEntities"
DefaultContainerName="AdventureWorksEntities"
EntitySetName="SalesOrderHeaders"
Select="it.SalesOrderID, it.TotalDue, it.OrderDate"
AutoGenerateOrderByClause="True">
<OrderByParameters>
    <asp:Parameter
    DefaultValue="TotalDue"/>
</OrderByParameters>
</asp:EntityDataSource>

Hinweise

Wenn die AutoGenerateOrderByClause -Eigenschaft des Steuerelements EntityDataSource auf truefestgelegt ist, generiert das Steuerelement automatisch eine ORDER BY-Klausel aus dem Parameter in der ParameterCollection der OrderByParameters -Eigenschaft zugewiesen. Dadurch entfällt die Notwendigkeit, der OrderBy -Eigenschaft explizit eine ORDER BY-Klausel zuzuweisen.

Wenn Sie die AutoGenerateOrderByClause -Eigenschaft auf truefestlegen, sollten Sie der OrderBy Eigenschaft nicht explizit einen Wert zuweisen.