共用方式為

SqlDataSourceView.SelectParameters 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得包含 SelectCommand 屬性所用參數的參數集合。

public:
 property System::Web::UI::WebControls::ParameterCollection ^ SelectParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
public System.Web.UI.WebControls.ParameterCollection SelectParameters { get; }
member this.SelectParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property SelectParameters As ParameterCollection

屬性值

ParameterCollection

ParameterCollection，包含 SelectCommand 屬性所使用的參數。

範例

下列程式代碼範例示範如何將 屬性設定 SelectCommand 為 SQL 查詢，以從 Microsoft SQL Server 中的 Northwind 資料庫擷取數據。 SQL 查詢會參數化，而且 屬性中的 SelectCommand 佔位元會與 ControlParameter 加入至 SelectParameters 集合的物件相符。 如此一來，所 DropDownList 系結的 控件 ControlParameter 會做為控件中所 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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">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>

備註

SelectCommand如果屬性包含參數化的 SQL 查詢，SelectParameters集合會Parameter包含任何對應至 SQL 字串中參數佔位元的物件。

視 ADO.NET 提供者而定，集合中的 SelectParameters 參數順序可能很重要。 System.Data.OleDb和 System.Data.Odbc 提供者會根據參數化 SQL 查詢中出現參數的順序，關聯集合中的參數。 提供者 System.Data.SqlClient 是控件的預設 ADO.NET 提供者 SqlDataSource ，會比對參數的名稱與 SQL 查詢中的佔位元別名，使集合中的參數產生關聯。 如需參數化 SQL 查詢和命令的詳細資訊，請參閱 搭配 SqlDataSource 控制項使用參數。

適用於

另請參閱