LinqDataSource.OrderByParameters 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Extensions.dll

取得用於建立 Order By 子句的參數集合。

public:
 property System::Web::UI::WebControls::ParameterCollection ^ OrderByParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection OrderByParameters { get; }

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.OrderByParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property OrderByParameters As ParameterCollection

屬性值

ParameterCollection

用來建立 Order By 子句的參數。

屬性

BrowsableAttribute PersistenceModeAttribute

範例

下列範例顯示將 LinqDataSource 屬性設定為 AutoGenerateOrderByClause 的 true 控制項。 參數包含在集合中 OrderByParameters ，該集合會根據使用者從 DropDownList 控制項選取的屬性名稱來排序資料。

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

備註

控制項 LinqDataSource 會使用集合中的 OrderByParameters 參數，在執行時間建立 Order By 子句。 當您將 AutoGenerateOrderByClause 參數新增至集合時，通常會將 屬性 true 設定為 OrderByParameters 。 AutoGenerateOrderByClause當 屬性設定為 true 時，集合中的每個 OrderByParameters 參數都會加入至集合中所 OrderByParameters 指定序列中的 Order By 子句。 AutoGenerateOrderByClause當 屬性為 true 時，參數不需要命名，因為它們會依序套用，而且與預留位置不相符。

如果您不需要在 Order By 子句中的執行時間設定值，就不需要使用 OrderByParameters 集合。 您可以定義用來排序 屬性中 OrderBy 資料的欄位。 例如，若要從排序 LastName 的資料庫資料表傳回值，請將 設定 OrderBy 為 「LastName」，而不需任何參數。

您可以在集合中 OrderByParameters 設定參數，並將參數與 屬性中的 OrderBy 預留位置相符，但此方法的應用程式有限。 當您使用此方法時，集合中的 OrderByParameters 參數不能代表資料行名稱。 您可以將參數設定為值，然後將該值與屬性中的值進行比較。 例如，您可以根據 屬性中的值是否小於 參數所代表的運行時間值來排序資料。