LinqDataSource.OrderByParameters Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.Extensions.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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.

Şunlara uygulanır

Aracılığıyla paylaş