SqlDataSourceView.FilterParameters プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlDataSourceView.FilterParameters プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

FilterExpression 文字列のパラメータプレースホルダに関連付けられたパラメータのコレクションを取得します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 FilterParameters As ParameterCollection

Visual Basic (使用法)

Dim instance As SqlDataSourceView
Dim value As ParameterCollection

value = instance.FilterParameters

public ParameterCollection FilterParameters { get;
 }

C++

public:
property ParameterCollection^ FilterParameters {
    ParameterCollection^ get ();
}

/** @property */
public ParameterCollection get_FilterParameters ()

JScript

public function get FilterParameters
 () : ParameterCollection

プロパティ値
FilterExpression プロパティに含まれる任意のパラメータプレースホルダに関連付けられたパラメータのセットを格納している ParameterCollection。

解説

FilterParameters コレクションのパラメータは、FilterExpression プロパティで指定された任意のパラメータと関連付けられます。FilterExpression で指定されているパラメータプレースホルダは、Select メソッドの呼び出し時に、順番に評価され、FilterParameters コレクション内のパラメータオブジェクトと照合されます。

セキュリティに関するメモ
クライアントから受け取ったフィルタパラメータ値を検証する必要があります。ランタイムは、パラメータ値をフィルタ式に代入して、Select メソッドによって返される DataView オブジェクトに適用します。FilterExpression プロパティをセキュリティ対策として使用して、返されるアイテムの数を制限している場合は、フィルタ処理が行われる前に、パラメータ値を検証する必要があります。

セキュリティに関するメモ

クライアントから受け取ったフィルタパラメータ値を検証する必要があります。ランタイムは、パラメータ値をフィルタ式に代入して、Select メソッドによって返される DataView オブジェクトに適用します。FilterExpression プロパティをセキュリティ対策として使用して、返されるアイテムの数を制限している場合は、フィルタ処理が行われる前に、パラメータ値を検証する必要があります。

使用例

Northwind データベースからデータを取得し、FilterExpression プロパティと FilterParameters プロパティを使用してフィルタ処理する方法を次のコード例に示します。Select メソッドを実行してデータを取得するときは常に、SqlDataSource コントロールの FilterExpression プロパティが適用されます。この例では、FilterExpression プロパティに、FilterParameters コレクションに格納されているフィルタパラメータのプレースホルダが格納されています。さらに、フィルタパラメータは、DropDownList コントロールの SelectedValue プロパティにバインドされている ControlParameter オブジェクトです。DropDownList コントロールの AutoPostBack プロパティが true に設定されているため、DropDownList の選択項目を変更すると、ページから情報がサーバーにポストバックされ、GridView コントロールが、新しいフィルタを持つデータソースコントロールにバインドし直されます。

Visual Basic

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

<HTML>
    <BODY>
        <FORM runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected>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>

        </FORM>
    </BODY>
</HTML>

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

<HTML>
    <BODY>
        <FORM runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected>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>

        </FORM>
    </BODY>
</HTML>

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

<HTML>
    <BODY>
        <FORM runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected>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="Data Source=localhost;Integrated Security=SSPI;Initial
 Catalog=Northwind;"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM
 Employees"
                FilterExpression="Title='@Title'">
                <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>

        </FORM>
    </BODY>
</HTML>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlDataSourceView クラス
SqlDataSourceView メンバ
System.Web.UI.WebControls 名前空間
SqlDataSourceView.FilterExpression プロパティ
SqlDataSource.DataSourceMode プロパティ

>> 「SqlDataSourceView.FilterParameters プロパティ」を含む用語の索引
SqlDataSourceView.FilterParameters プロパティのページへのリンク


	© 2025 Microsoft.All rights reserved.

SqlDataSourceView.FilterParameters プロパティとは？ わかりやすく解説

SqlDataSourceView.FilterParameters プロパティ

急上昇のことば

SqlDataSourceView.FilterParameters プロパティとは？わかりやすく解説