次の方法で共有


EntityDataSource.AutoGenerateOrderByClause プロパティ

定義

EntityDataSource コントロールが OrderByParameters コレクション内の値に基づいて ORDER BY 句を動的に作成するかどうかを示す値を取得または設定します。

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

プロパティ値

EntityDataSource コントロールが ORDER BY 句を作成する場合は true。それ以外の場合 false。 既定値は false です。

例外

AutoGenerateOrderByClause プロパティが true に設定されており、OrderBy プロパティが null でない場合。

次の例では、ORDER BY 句を自動的に生成し、 の OrderByDropDownList 値を使用して パラメーターの値を設定します。

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

次の例では、ORDER BY 句を自動的に生成し、 要素の 属性をDefaultValueParameter使用して パラメーターの値を設定します。

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

注釈

コントロールの AutoGenerateOrderByClauseEntityDataSource プロパティが に設定されている場合、コントロールは、 プロパティに true割り当てられた 内の ParameterCollection パラメーターから ORDER BY 句を OrderByParameters 自動的に生成します。 これにより、ORDER BY 句をプロパティに明示的に割り当てる必要がなくなります OrderBy

プロパティを にtrue設定するAutoGenerateOrderByClause場合は、プロパティに値を明示的に割り当てないようにするOrderBy必要があります。

適用対象