Bagikan melalui

SqlDataSourceView.FilterParameters Properti

Definisi

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

Mendapatkan kumpulan parameter yang terkait dengan tempat penampung parameter apa pun dalam FilterExpression string.

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

Nilai Properti

ParameterCollection

ParameterCollection yang berisi sekumpulan parameter yang terkait dengan tempat penampung parameter apa pun yang ditemukan di FilterExpression properti .

Atribut
PersistenceModeAttribute

Contoh

Contoh kode berikut menunjukkan cara mengambil data dari database Northwind dan memfilternya menggunakan FilterExpression properti dan FilterParameters . Properti FilterExpressionSqlDataSource kontrol diterapkan kapan saja Select metode dijalankan untuk mengambil data. Dalam contoh ini, FilterExpression properti berisi tempat penampung untuk parameter filter, yang terkandung dalam FilterParameters koleksi. Selain itu, parameter filter adalah ControlParameter objek yang terikat ke SelectedValue properti DropDownList kontrol. DropDownList Karena kontrol memiliki properti yang AutoPostBack diatur ke true, setiap perubahan dalam DropDownList pilihan menyebabkan halaman memposting informasi kembali ke server dan GridView kontrol untuk mengikat kembali ke kontrol sumber data dengan filter baru.

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

Keterangan

Parameter dalam koleksi dikaitkan FilterParameters dengan parameter apa pun yang ditentukan dalam FilterExpression properti . Tempat penampung parameter yang ditentukan dalam FilterExpression dievaluasi berdasarkan urutan dan dicocokkan dengan objek parameter dalam FilterParameters koleksi saat metode dipanggil Select .

Penting

Anda harus memvalidasi nilai parameter filter apa pun yang Anda terima dari klien. Runtime hanya mengganti nilai parameter ke dalam ekspresi filter dan menerapkannya ke DataView objek yang dikembalikan oleh Select metode . Jika Anda menggunakan FilterExpression properti sebagai langkah keamanan untuk membatasi jumlah item yang dikembalikan, Anda harus memvalidasi nilai parameter sebelum pemfilteran terjadi.

Berlaku untuk

Lihat juga