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 FilterExpression özelliklerini kullanarak verileri filtrelemeyi FilterParameters 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 ControlParameter özelliğine SelectedValue bağlı bir DropDownList nesnedir. Denetimin özelliği olarak DropDownListayarlandığındanAutoPostBack, seçimdeki true herhangi bir değişiklik sayfanın bilgileri sunucuya geri göndermesine ve denetimin DropDownList yeni filtreyle veri kaynağı denetimine yeniden bağlamasına neden olur.GridView

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

Important

İ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 DataView döndürülen nesneye Select 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.