EntityDataSource.AutoGenerateOrderByClause Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Entity.dll

Denetimin koleksiyondaki EntityDataSourceOrderByParameters değerlere göre dinamik olarak ORDER BY yan tümcesi oluşturup oluşturmadığını gösteren bir değer alır veya ayarlar.

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

Özellik Değeri

Boolean

true EntityDataSource denetim ORDER BY yan tümcesini oluşturursa; değilse, false. Varsayılan değer false değeridir.

Özel durumlar

InvalidOperationException

AutoGenerateOrderByClause özelliği olarak ayarlandığında true ve OrderBy özelliği null olmadığında.

Örnekler

Aşağıdaki örnek ORDER BY yan tümcesini otomatik olarak oluşturur ve parametresinin OrderByDropDownList değerini ayarlamak için değerini kullanır.

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

Aşağıdaki örnek, ORDER BY yan tümcesini otomatik olarak oluşturur ve parametresinin Parameter değerini ayarlamak için öğesinin özniteliğini kullanırDefaultValue.

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

Açıklamalar

Denetimin AutoGenerateOrderByClauseEntityDataSource özelliği olarak ayarlandığında, denetim özelliğine trueatanan parametresinden ParameterCollection otomatik olarak bir ORDER BY yan tümcesi OrderByParameters oluşturur. Bu, özelliğine bir ORDER BY yan tümcesi atama gereksinimini OrderBy ortadan kaldırır.

özelliğini olarak ayarlarsanızAutoGenerateOrderByClause, özelliğine trueOrderBy açıkça bir değer atamamalısınız.