LinqDataSource.AutoGenerateOrderByClause Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.Extensions.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah LinqDataSource kontrol secara dinamis membuat klausa Order By berdasarkan nilai dalam OrderByParameters koleksi.

public:
 property bool AutoGenerateOrderByClause { bool get(); void set(bool value); };
public bool AutoGenerateOrderByClause { get; set; }
member this.AutoGenerateOrderByClause : bool with get, set
Public Property AutoGenerateOrderByClause As Boolean

Nilai Properti

Boolean

true LinqDataSource jika kontrol membuat klausa Order By; jika tidak, false. Defaultnya adalah false.

Contoh

Contoh berikut menunjukkan LinqDataSource kontrol dengan diatur ke AutoGenerateOrderByClausetrue. Parameter disertakan dalam OrderByParameters koleksi yang mengurutkan data berdasarkan nama properti yang dipilih pengguna dari DropDownList kontrol.

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

Keterangan

Saat Anda mengatur AutoGenerateOrderByClause properti ke true, LinqDataSource kontrol secara dinamis membuat klausa Order By yang didasarkan pada nilai dalam OrderByParameters koleksi. Kontrol LinqDataSource mengurutkan data menurut parameter pertama lalu juga mengurutkan data untuk setiap parameter tambahan. Parameter yang berisi null atau nilai kosong tidak disertakan dalam klausa Order By.

Anda tidak mengatur OrderBy properti saat AutoGenerateOrderByClause diatur ke true, karena pengurai secara dinamis membuat klausa Order By. Kontrol LinqDataSource melemparkan pengecualian jika AutoGenerateOrderByClause diatur ke true dan OrderBy properti ditetapkan nilai.

Berlaku untuk