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

すべての辞書から再検索する

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

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

SqlDataSourceFilteringEventArgs.ParameterValues プロパティ

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

SqlDataSource クラスの Parameter オブジェクトへのアクセスを提供する IOrderedDictionary オブジェクトを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 ParameterValues As IOrderedDictionary

Visual Basic (使用法)

Dim instance As SqlDataSourceFilteringEventArgs
Dim value As IOrderedDictionary

value = instance.ParameterValues

public IOrderedDictionary ParameterValues { get;
 }

C++

public:
property IOrderedDictionary^ ParameterValues {
    IOrderedDictionary^ get ();
}

/** @property */
public IOrderedDictionary get_ParameterValues ()

JScript

public function get ParameterValues
 () : IOrderedDictionary

プロパティ値
Parameter オブジェクトの IOrderedDictionary。

解説

SqlDataSourceFilteringEventArgs クラスは、データを SqlDataSource の Filtering イベントハンドラに渡す場合に使用されます。ParameterValues プロパティは、フィルタ操作を実行する前に、フィルタパラメータ値へのアクセスを提供します。

セキュリティに関するメモ
クライアントから受け取ったフィルタパラメータ値を検証し、無効なパラメータが存在した場合は、選択操作をキャンセルする必要があります。ランタイムは、パラメータ値をフィルタ式に代入し、それを選択メソッドの結果に対して適用するだけです。想定外の値によってフィルタ式が改変され、クライアントに見せるべきでない行まで表示させるような不正が生じる可能性もあります。FilterExpression プロパティをセキュリティ対策として使用して、返される項目数を制限する場合は、フィルタ処理の実行前にパラメータ値を検証する必要があります。

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

クライアントから受け取ったフィルタパラメータ値を検証し、無効なパラメータが存在した場合は、選択操作をキャンセルする必要があります。ランタイムは、パラメータ値をフィルタ式に代入し、それを選択メソッドの結果に対して適用するだけです。想定外の値によってフィルタ式が改変され、クライアントに見せるべきでない行まで表示させるような不正が生じる可能性もあります。FilterExpression プロパティをセキュリティ対策として使用して、返される項目数を制限する場合は、フィルタ処理の実行前にパラメータ値を検証する必要があります。

使用例

Northwind データベースからデータを取得し、FilterExpression と FilterParameters を使用してフィルタ処理する方法を次のコード例に示します。Select メソッドを実行してデータを取得するときは常に、SqlDataSource の FilterExpression が適用されます。この例では、FilterExpression に、FilterParameters コレクションに格納されているフィルタパラメータのプレースホルダが格納されています。Filtering イベントで、フィルタパラメータが Label コントロールに表示されます。

Visual Basic

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

<script runat="server">

    Protected Sub SqlDataSource1_Filtering(ByVal
 sender As Object, _
        ByVal e As System.Web.UI.WebControls.SqlDataSourceFilteringEventArgs)
        Label1.Text = e.ParameterValues(0).ToString()
    End Sub
</script>

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

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem>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:NorthwindConnection
 %>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title
 FROM Employees"
                FilterExpression="Title='{0}'" OnFiltering="SqlDataSource1_Filtering">
                <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>
                <asp:Label ID="Label1" runat="server"
 Text="Label"></asp:Label>

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

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    //Protected Sub SqlDataSource1_Filtering(ByVal sender As Object,
 _
    //    ByVal e As System.Web.UI.WebControls.SqlDataSourceFilteringEventArgs)
    //    Label1.Text = e.ParameterValues(0).ToString()
    //End Sub


    protected void SqlDataSource1_Filtering(object
 sender, SqlDataSourceFilteringEventArgs e)
    {
        Label1.Text = e.ParameterValues[0].ToString();
    }
</script>

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

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem>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:NorthwindConnection
 %>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM
 Employees"
                FilterExpression="Title='{0}'" OnFiltering="SqlDataSource1_Filtering">
                <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>
                <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>

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

参照

関連項目
SqlDataSourceFilteringEventArgs クラス
SqlDataSourceFilteringEventArgs メンバ
System.Web.UI.WebControls 名前空間
SqlDataSource.FilterParameters プロパティ
SqlDataSource.FilterExpression プロパティ
SqlDataSource.Filtering イベント
SqlDataSourceFilteringEventHandler
Cancel

このページでは「.NET Framework クラスライブラリリファレンス」からSqlDataSourceFilteringEventArgs.ParameterValues プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からSqlDataSourceFilteringEventArgs.ParameterValues プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からSqlDataSourceFilteringEventArgs.ParameterValues プロパティを検索

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

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

SqlDataSourceFilteringEventArgs.ParameterValues プロパティ

「SqlDataSourceFilteringEventArgs.ParameterValues プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

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

SqlDataSourceFilteringEventArgs.ParameterValues プロパティ

急上昇のことば

「SqlDataSourceFilteringEventArgs.ParameterValues プロパティ」の関連用語

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