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ış truebir LinqDataSource denetim AutoGenerateOrderByClause gösterilmektedir. 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 AutoGenerateOrderByClause true parametre OrderByParameters eklerken özelliğini olarak ayarlarsınız. AutoGenerateOrderByClause özelliği olarak ayarlandığındatrue, koleksiyondaki OrderByParameters her parametre, koleksiyonda belirtilen sırayla 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 "LastName" olarak ayarlayın OrderBy .

Koleksiyondaki OrderByParameters parametreleri ayarlayabilir ve parametreleri özelliğindeki yer tutucularla eşleştirebilirsiniz, ancak bu yaklaşımın OrderBy sınırlı uygulaması vardı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.