LinqDataSource.OrderByParameters Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.Extensions.dll

Hämtar den samling parametrar som används för att skapa Order By-satsen.

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

Egenskapsvärde

ParameterCollection

De parametrar som används för att skapa Order By-satsen.

Attribut
BrowsableAttribute PersistenceModeAttribute

Exempel

I följande exempel visas en LinqDataSource kontroll med egenskapen inställd på AutoGenerateOrderByClausetrue. En parameter ingår i samlingen OrderByParameters som beställer data baserat på egenskapsnamnet som en användare väljer från en DropDownList kontroll.

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

Kommentarer

Kontrollen LinqDataSource använder parametrar i OrderByParameters samlingen för att skapa Order By-satsen vid körning. Vanligtvis anger du egenskapen AutoGenerateOrderByClause till true när du lägger till parametrar i OrderByParameters samlingen. När egenskapen AutoGenerateOrderByClause är inställd truepå läggs varje parameter i OrderByParameters samlingen till i Order By-satsen i sekvensen som de anges i OrderByParameters samlingen. När egenskapen AutoGenerateOrderByClause är truebehöver parametrarna inte namnges eftersom de tillämpas i följd och inte matchas med en platshållare.

Om du inte behöver ange ett värde vid körning i Order By-satsen behöver du inte använda OrderByParameters samlingen. Du kan definiera de fält som ska användas för att sortera data i egenskapen OrderBy . Om du till exempel vill returnera värden från en databastabell sorterad efter LastNameanger du OrderBy till "LastName" utan några parametrar.

Du kan ange parametrar i OrderByParameters samlingen och matcha parametrarna till platshållare i OrderBy egenskapen, men den här metoden har ett begränsat program. När du använder den här metoden kan parametrarna OrderByParameters i samlingen inte representera ett kolumnnamn. Du kan ange ett värde för en parameter och sedan jämföra värdet med värden i en egenskap. Du kan till exempel sortera data baserat på om värdena i en egenskap är mindre än det körningsvärde som representeras av parametern.

Gäller för