SqlDataSourceView.SelectParameters プロパティ
アセンブリ: System.Web (system.web.dll 内)

Dim instance As SqlDataSourceView Dim value As ParameterCollection value = instance.SelectParameters
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 コントロールにおけるパラメータの使用」を参照してください。

SelectCommand プロパティを SQL クエリに設定して、Microsoft SQL Server 内の Northwind データベースからデータを取得する方法を次のコード例に示します。SQL クエリがパラメータ化され、SelectCommandプロパティ内のプレースホルダが SelectParameters コレクションに追加された ControlParameter オブジェクトと照合されます。このようにして、ControlParameter がバインドされる DropDownList コントロールは、ListBox コントロールに表示される項目のフィルタとして機能します。
![]() |
---|
パラメータは WHERE 句で使用されているため、このコード例での SelectParameters プロパティの使用は、機能的には FilterExpression プロパティと FilterParameters プロパティの両方を使用することと等価です。 |
<!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>
<!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>
<!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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- SqlDataSourceView.SelectParameters プロパティのページへのリンク