Aracılığıyla paylaş

SqlDataSourceView.FilterParameters Özellik

Tanım

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

Dizedeki FilterExpression tüm parametre yer tutucularıyla ilişkili bir parametre koleksiyonu 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şkilendirilmiş 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 FilterExpressionSqlDataSource özelliği, veri almak için yöntem yürütülürken her zaman Select uygulanır. Bu örnekte özelliği, FilterExpression koleksiyonda FilterParameters yer alan filtre parametresi için bir yer tutucu içerir. Ayrıca, filtre parametresi denetimin SelectedValue özelliğine DropDownList bağlı bir ControlParameter nesnedir. Denetimin özelliği olarak trueayarlandığındanDropDownList, 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.AutoPostBack

<!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 herhangi bir filtre parametresi değerini 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 bir güvenlik önlemi olarak özelliğini kullanıyorsanız FilterExpression , filtreleme gerçekleşmeden önce parametre değerlerini doğrulamanız gerekir.

Şunlara uygulanır

Ayrıca bkz.