Aracılığıyla paylaş

SqlDataSourceView.FilterParameters Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Dizedeki herhangi bir parametre yer tutucusu FilterExpression ile ilişkili parametre koleksiyonunu alır.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ FilterParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection FilterParameters { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.FilterParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property FilterParameters As ParameterCollection

Özellik Değeri

ParameterCollection

ParameterCollection özelliğinde FilterExpression bulunan tüm parametre yer tutucularıyla ilişkili bir parametre kümesi içeren.

Öznitelikler
PersistenceModeAttribute

Örnekler

Aşağıdaki kod örneği, Northwind veritabanından veri almayı ve ve FilterParameters özelliklerini kullanarak verileri filtrelemeyi FilterExpression gösterir. Denetimin FilterExpression SqlDataSource özelliği, veri almak için yöntem her yürütildiğinde uygulanır Select . Bu örnekte özelliği, FilterExpression koleksiyonda FilterParameters yer alan bir filtre parametresi için yer tutucu içerir. Ayrıca, filtre parametresi denetimin SelectedValue özelliğine DropDownList bağlı bir ControlParameter nesnedir. Denetimin DropDownList AutoPostBack özelliği olarak ayarlandığından true, seçimdeki DropDownList herhangi bir değişiklik sayfanın bilgileri sunucuya geri göndermesine ve denetimin GridView yeni filtreyle veri kaynağı denetimine yeniden bağlamasına neden olur.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected="True">Sales Representative</asp:ListItem>
                <asp:ListItem>Sales Manager</asp:ListItem>
                <asp:ListItem>Vice President, Sales</asp:ListItem>
            </asp:DropDownList></p>

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
                FilterExpression="Title='{0}'">
                <FilterParameters>
                    <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
                </FilterParameters>
            </asp:SqlDataSource>

            <p><asp:GridView
                id="GridView1"
                runat="server"
                DataSourceID="SqlDataSource1"
                AutoGenerateColumns="False">
                <columns>
                    <asp:BoundField Visible="False" DataField="EmployeeID" />
                    <asp:BoundField HeaderText="First Name" DataField="FirstName" />
                    <asp:BoundField HeaderText="Last Name" DataField="LastName" />
                </columns>
            </asp:GridView></p>

        </form>
    </body>
</html>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected="True">Sales Representative</asp:ListItem>
                <asp:ListItem>Sales Manager</asp:ListItem>
                <asp:ListItem>Vice President, Sales</asp:ListItem>
            </asp:DropDownList></p>

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
                FilterExpression="Title='{0}'">
                <FilterParameters>
                    <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
                </FilterParameters>
            </asp:SqlDataSource>

            <p><asp:GridView
                id="GridView1"
                runat="server"
                DataSourceID="SqlDataSource1"
                AutoGenerateColumns="False">
                <columns>
                    <asp:BoundField Visible="False" DataField="EmployeeID" />
                    <asp:BoundField HeaderText="First Name" DataField="FirstName" />
                    <asp:BoundField HeaderText="Last Name" DataField="LastName" />
                </columns>
            </asp:GridView></p>

        </form>
    </body>
</html>

Açıklamalar

Koleksiyondaki FilterParameters parametreler özelliğinde FilterExpression belirtilen tüm parametrelerle ilişkilendirilir. içinde FilterExpression belirtilen parametre yer tutucuları sırasıyla değerlendirilir ve yöntem çağrıldığında koleksiyondaki FilterParameters parametre nesneleriyle Select eşleştirilir.

Önemli

İstemciden aldığınız tüm filtre parametresi değerlerini doğrulamanız gerekir. Çalışma zamanı, parametre değerini filtre ifadesiyle değiştirerek yöntemi tarafından Select döndürülen nesneye DataView uygular. Döndürülen öğe sayısını sınırlamak için özelliğini bir güvenlik önlemi olarak kullanıyorsanız FilterExpression , filtreleme gerçekleşmeden önce parametre değerlerini doğrulamanız gerekir.

Şunlara uygulanır

Ayrıca bkz.