SqlDataSource.SelectParameters プロパティ

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

SqlDataSource.SelectParameters プロパティ

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

SqlDataSource コントロールに関連付けられた SqlDataSourceView オブジェクトから、SelectCommand プロパティで使用されるパラメータを格納するパラメータ コレクションを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 SelectParameters As ParameterCollection

Visual Basic (使用法)

Dim instance As SqlDataSource
Dim value As ParameterCollection

value = instance.SelectParameters

C#

public ParameterCollection SelectParameters { get;
 }

C++

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

J#

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

JScript

public function get SelectParameters
 () : ParameterCollection

プロパティ値
SelectCommand プロパティによって使用されるパラメータを格納している ParameterCollection。

解説

SelectCommand プロパティにパラメータ化された SQL クエリが含まれている場合、SelectParameters コレクションには、SQL 文字列内のパラメータ プレースホルダに対応する Parameter オブジェクトが含まれます。

ADO.NET プロバイダによっては、SelectParameters コレクションのパラメータの順序が重要になる場合があります。System.Data.OleDb プロバイダおよび System.Data.Odbc プロバイダは、コレクション内のパラメータをパラメータ化された SQL クエリでの指定順序に従って関連付けます。SqlDataSource コントロールの既定の ADO.NET プロバイダである System.Data.SqlClient プロバイダは、パラメータ名と、SQL クエリ内のプレースホルダ エイリアスとを照らし合わせることにより、コレクション内のパラメータを関連付けます。パラメータ化された SQL クエリとコマンドの詳細については、「SqlDataSource コントロールにおけるパラメータの使用」を参照してください。

SelectParameters プロパティは、SqlDataSource コントロールに関連付けられた SqlDataSourceView オブジェクトが格納する SelectParameters プロパティを取得します。

使用例

SelectCommand プロパティを SQL クエリに設定して、Microsoft SQL Server 内の Northwind データベースからデータを取得する方法を次のコード例に示します。SQL クエリがパラメータ化され、SelectCommandプロパティ内のプレースホルダが SelectParameters コレクションに追加された ControlParameter オブジェクトと照合されます。ControlParameter がバインドされる DropDownList コントロールは、ListBox コントロールに表示される項目のフィルタとして機能します。

メモ
パラメータは WHERE 句で使用されているため、このコード例での SelectParameters プロパティの使用は、機能的には FilterExpression プロパティと FilterParameters プロパティを使用することと等価です。

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><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 LastName FROM Employees WHERE
 Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title"
 controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

C#

<!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><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 LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1"
 propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

J#

<!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><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 LastName FROM Employees WHERE Title = @Title">
          <SelectParameters>
              <asp:ControlParameter Name="Title" ControlId="DropDownList1"
 PropertyName="SelectedValue"/>
          </SelectParameters>
      </asp:SqlDataSource>

      <p><asp:ListBox
          id="ListBox1"
          runat="server"
          DataSourceID="SqlDataSource1"
          DataTextField="LastName">
      </asp:ListBox></p>

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

参照

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