EntityDataSource.AutoGenerateOrderByClause プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.Entity.dll

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

プロパティ値

Boolean

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

例外

InvalidOperationException

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必要があります。

適用対象