LinqDataSource.OrderByParameters Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá kolekci parametrů, které se používají k vytvoření klauzule 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

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á objednává 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 kolekci OrderByParameters k vytvoření klauzule Order By za běhu. Vlastnost obvykle nastavíte AutoGenerateOrderByClause , true když do kolekce přidáte parametry OrderByParameters . AutoGenerateOrderByClause Pokud je vlastnost nastavena na true, každý parametr v OrderByParameters kolekci se přidá do klauzule Order By v posloupnosti, kterou jsou zadány v kolekciOrderByParameters. AutoGenerateOrderByClause Pokud je truevlastnost , parametry nemusí být pojmenovány, protože jsou použity v posloupnosti a nejsou spárovány se zástupným symbolem.

Pokud v klauzuli Order By nemusíte v klauzuli Order By nastavit hodnotu za běhu, nemusíte kolekci OrderByParameters používat. Pole, která se mají použít k řazení dat ve OrderBy vlastnosti, můžete definovat. Chcete-li například vrátit hodnoty z databázové tabulky seřazené podle LastNamehodnoty , nastavte OrderBy na "LastName" bez jakýchkoli parametrů.

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

Platí pro

Sdílet prostřednictvím