LinqDataSource.WhereParameters Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

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

public:
 property System::Web::UI::WebControls::ParameterCollection ^ WhereParameters { 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 WhereParameters { get; }

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.WhereParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property WhereParameters As ParameterCollection

Özellik Değeri

ParameterCollection

özelliğinde Where yan tümcesini oluşturmak için kullanılan parametrelerin Where koleksiyonu.

Uygulamalar

WhereParameters

Öznitelikler

BrowsableAttribute PersistenceModeAttribute

Örnekler

Aşağıdaki örnekte, Where yan tümcesini WhereParameters dinamik olarak oluşturmak için koleksiyonun nasıl kullanılacağı gösterilmektedir. Denetim, LinqDataSource sütunda bir denetimdeki Price kullanıcı DropDownList tarafından seçilen değerden daha büyük bir değere sahip olan tüm kayıtları döndürür.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price>@UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > @UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Açıklamalar

Denetim, LinqDataSource çalışma zamanında Where yan tümcesini oluşturmak için koleksiyondaki WhereParameters parametreleri kullanır. Where yan tümcesindeki koşullardan WhereParameters birini veya daha fazlasını program aracılığıyla ayarlamak istediğinizde koleksiyona parametre eklersiniz. Örneğin, bir veritabanı tablosunda, bir denetimin değerine TextBox eşit soyadına sahip kayıtları arayabilirsiniz. Bu durumda, metin kutusu değeri için koleksiyona WhereParameters bir parametre eklersiniz.

Where yan tümcesinde çalışma zamanında bir değer ayarlamanız gerekmezse, koleksiyonu kullanmanız WhereParameters gerekmez. özelliğinde Where alınacak alanları tanımlayabilirsiniz. Örneğin, işaretlemede "Adams" değerine eşit olan LastName bir veritabanı tablosundan değerler döndürmek için özelliği parametresiz olarak 'LastName = "Adams"' ayarlayınWhere.

Koleksiyondaki WhereParameters değerleri ayarlamak için her parametreye bir ad atar ve ardından bu parametrenin özelliğine Where bir yer tutucu eklersiniz. Where yan tümcesinde, her parametre adının önüne @ simgesi koyun.