LinqDataSource.OrderByParameters Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Extensions.dll

Získá kolekci parametrů, které se používají k vytvoření Order By klauzule.

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

Hodnota vlastnosti

ParameterCollection

Parametry, které se používají k vytvoření klauzule Order By.

Atributy

BrowsableAttribute PersistenceModeAttribute

Příklady

Následující příklad ukazuje LinqDataSource ovládací prvek s vlastností nastavenou AutoGenerateOrderByClause na true. Parametr je součástí OrderByParameters kolekce, která seřadí data na základě názvu vlastnosti, který uživatel vybere z DropDownList ovládacího prvku.

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

Poznámky

Ovládací LinqDataSource prvek používá parametry v OrderByParameters kolekci k vytvoření klauzule Order By za běhu. Vlastnost true obvykle nastavíte AutoGenerateOrderByClause při přidávání parametrů do OrderByParameters kolekce. Pokud je vlastnost nastavena AutoGenerateOrderByClause na true, každý parametr v OrderByParameters kolekci se přidá do klauzule Order By v pořadí, které jsou zadány v kolekci OrderByParameters . AutoGenerateOrderByClause Pokud je truevlastnost , parametry nemusí být pojmenovány, protože jsou použity v posloupnosti a nejsou shodné se zástupným symbolem.

Pokud v klauzuli Order By nemusíte v klauzuli Order By nastavovat hodnotu za běhu, nemusíte kolekci OrderByParameters používat. Můžete definovat pole, která se mají použít k řazení dat ve OrderBy vlastnosti. Pokud například chcete vracet hodnoty z databázové tabulky seřazené podle LastName, nastavte OrderBy na "LastName" bez jakýchkoli parametrů.

V kolekci OrderByParameters můžete nastavit parametry a odpovídat parametrům zástupným symbolům ve OrderBy vlastnosti, ale tento přístup má omezenou aplikaci. Při použití tohoto přístupu nemohou parametry v OrderByParameters kolekci představovat název sloupce. Parametr můžete nastavit na hodnotu a pak tuto hodnotu porovnat s hodnotami ve vlastnosti. Data můžete například uspořádat na základě toho, jestli jsou hodnoty ve vlastnosti menší než hodnota za běhu reprezentovaná parametrem.