EntityDataSource.AutoGenerateOrderByClause Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se il controllo EntityDataSource crea dinamicamente una clausola ORDER BY in base ai valori della raccolta OrderByParameters.
public:
property bool AutoGenerateOrderByClause { bool get(); void set(bool value); };public bool AutoGenerateOrderByClause { get; set; }member this.AutoGenerateOrderByClause : bool with get, setPublic Property AutoGenerateOrderByClause As BooleanValore della proprietà
true se il controllo EntityDataSource crea la clausola ORDER BY; in caso contrario, false. Il valore predefinito è false.
Eccezioni
Se la proprietà AutoGenerateOrderByClause è impostata su true e la proprietà OrderBy non è Null.
Esempio
Nell'esempio seguente viene generata automaticamente la clausola ORDER BY e viene utilizzato il valore di OrderByDropDownList per impostare il valore del parametro.
<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>
Nell'esempio seguente viene generata automaticamente la clausola ORDER BY e viene utilizzato l' DefaultValue attributo dell' Parameter elemento per impostare il valore del parametro.
<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>
Commenti
Quando la AutoGenerateOrderByClause proprietà del EntityDataSource controllo è impostata su true , il controllo genera automaticamente una clausola ORDER BY dal parametro nell'oggetto ParameterCollection assegnato alla OrderByParameters Proprietà. In questo modo si elimina la necessità di assegnare esplicitamente una clausola ORDER BY alla OrderBy Proprietà.
Se si imposta la AutoGenerateOrderByClause proprietà su true , è consigliabile non assegnare in modo esplicito un valore alla OrderBy Proprietà.