LinqDataSource.OrderByParameters Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

Order By yan tümcesini oluşturmak için kullanılan parametre koleksiyonunu alır.

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

Özellik Değeri

ParameterCollection

Order By yan tümcesini oluşturmak için kullanılan parametreler.

Öznitelikler

BrowsableAttribute PersistenceModeAttribute

Örnekler

Aşağıdaki örnekte özelliği olarak ayarlanmış bir LinqDataSource denetim AutoGenerateOrderByClause gösterilmektedir true. Kullanıcının denetimden seçtiği özellik adına göre verileri sıralayan koleksiyona bir DropDownList parametre eklenirOrderByParameters.

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

Açıklamalar

Denetim, LinqDataSource çalışma zamanında Order By yan tümcesini oluşturmak için koleksiyondaki OrderByParameters parametreleri kullanır. Genellikle koleksiyona AutoGenerateOrderByClausetrue parametre OrderByParameters eklediğinizde özelliğini olarak ayarlarsınız. AutoGenerateOrderByClause özelliği olarak trueayarlandığında, koleksiyondaki OrderByParameters her parametre koleksiyonda belirtilen dizideki Order By yan tümcesine OrderByParameters eklenir. AutoGenerateOrderByClause özelliği olduğundatrue, parametreler sırayla uygulandığından ve bir yer tutucuyla eşleşmediğinden, parametrelerin adlandırılması gerekmez.

Order By yan tümcesinde çalışma zamanında bir değer ayarlamanız gerekmezse, koleksiyonu kullanmanız OrderByParameters gerekmez. Özelliğindeki verileri OrderBy sıralamak için kullanılacak alanları tanımlayabilirsiniz. Örneğin, tarafından LastNamesıralanmış bir veritabanı tablosundan değer döndürmek için parametresiz olarak "LastName" olarak ayarlayın OrderBy .

Koleksiyonda OrderByParameters parametreler ayarlayabilir ve parametreleri özelliğindeki yer tutucularla eşleştirebilirsiniz, ancak bu yaklaşımın OrderBy uygulaması sınırlıdır. Bu yaklaşımı kullandığınızda, koleksiyondaki OrderByParameters parametreler bir sütun adını temsil edemez. Parametreyi bir değere ayarlayabilir ve ardından bu değeri bir özellikteki değerlerle karşılaştırabilirsiniz. Örneğin, bir özellikteki değerlerin parametresiyle temsil edilen çalışma zamanı değerinden küçük olup olmadığına bağlı olarak verileri sıralayabilirsiniz.