EntityDataSource.AutoGenerateOrderByClause Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Entity.dll

EntityDataSourceDenetimin koleksiyondaki 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 OrderByParameters .

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

trueEntityDataSourceDENETIM order by yan tümcesini oluşturursa; Aksi durumda, false . false varsayılan değerdir.

Ö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 OrderByDropDownList parametresinin 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 DefaultValue Parameter parametresinin değerini ayarlamak için öğesinin özniteliğini kullanır.

<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

AutoGenerateOrderByClause EntityDataSource Denetimin özelliği olarak ayarlandığında true , denetim, özelliği atanan parametresinden OTOMATIK olarak bir order by yan tümcesi oluşturur ParameterCollection OrderByParameters . Bu, açıkça ORDER BY yan tümcesini özelliğe atama gereksinimini ortadan kaldırır OrderBy .

AutoGenerateOrderByClauseÖzelliğini olarak ayarlarsanız true , özelliği açıkça bir değer atamanız gerekir OrderBy .