SqlDataSourceFilteringEventArgs クラスとは何？わかりやすく解説 Weblio辞書

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

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

SqlDataSourceFilteringEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

SqlDataSource コントロールの Filtering イベントのデータを提供します。

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

Visual Basic (宣言)

Public Class SqlDataSourceFilteringEventArgs
    Inherits CancelEventArgs

Visual Basic (使用法)

Dim instance As SqlDataSourceFilteringEventArgs

public class SqlDataSourceFilteringEventArgs
 : CancelEventArgs

C++

public ref class SqlDataSourceFilteringEventArgs
 : public CancelEventArgs

public class SqlDataSourceFilteringEventArgs
 extends CancelEventArgs

JScript

public class SqlDataSourceFilteringEventArgs
 extends CancelEventArgs

解説

SqlDataSourceFilteringEventArgs クラスは、データを SqlDataSource コントロールの Filtering イベントハンドラに渡す場合に使用されます。ParameterValues プロパティは、フィルタ操作を実行する前に、フィルタパラメータ値へのアクセスを提供します。ObjectDataSourceFilteringEventArgs の Cancel プロパティを true に設定すると、Select メソッドをキャンセルできます。DataSourceMode プロパティの値が DataSet に設定されている場合、フィルタ処理がサポートされます。

使用例

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>

継承階層

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.SqlDataSourceFilteringEventArgs

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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 メンバ
System.Web.UI.WebControls 名前空間
SqlDataSource.FilterParameters プロパティ
SqlDataSource.FilterExpression プロパティ
SqlDataSource.Filtering イベント
SqlDataSourceFilteringEventHandler
Cancel

>> 「SqlDataSourceFilteringEventArgs クラス」を含む用語の索引
SqlDataSourceFilteringEventArgs クラスのページへのリンク

SqlDataSourceFilteringEventArgs クラスとは？わかりやすく解説

SqlDataSourceFilteringEventArgs クラス

「SqlDataSourceFilteringEventArgs クラス」の関連用語


	© 2025 Microsoft.All rights reserved.

SqlDataSourceFilteringEventArgs クラスとは？ わかりやすく解説

SqlDataSourceFilteringEventArgs クラス

急上昇のことば

「SqlDataSourceFilteringEventArgs クラス」の関連用語

SqlDataSourceFilteringEventArgs クラスとは？わかりやすく解説