Freigeben über

SqlDataSourceView.SelectParameters Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die Parameterauflistung ab, die die von der SelectCommand-Eigenschaft verwendeten Parameter enthält.

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

Eigenschaftswert

ParameterCollection

Eine ParameterCollection, die die von der SelectCommand-Eigenschaft verwendeten Parameter enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Daten aus der Northwind-Datenbank in Microsoft SQL Server abgerufen werden, indem Sie die SelectCommand Eigenschaft auf eine SQL-Abfrage festlegen. Die SQL-Abfrage wird parameterisiert, und der Platzhalter in der SelectCommand Eigenschaft wird dem Objekt zugeordnet, das der SelectParameters Auflistung hinzugefügt wirdControlParameter. Auf diese Weise fungiert das Steuerelement, an das die DropDownList Bindung gebunden ist, ControlParameter als Filter für das ListBox , was im Steuerelement angezeigt wird.

Hinweis

Da der Parameter in einer WHERE-Klausel verwendet wird, entspricht die Verwendung der SelectParameters Eigenschaft in diesem Codebeispiel funktionell dem Verwenden FilterExpression der Eigenschaften und FilterParameters Eigenschaften.

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

Hinweise

Wenn die Eigenschaft eine parameterisierte SQL-Abfrage enthält, enthält die SelectCommand SelectParameters Auflistung alle Parameter Objekte, die den Parameterplatzhaltern in der SQL Zeichenfolge entsprechen.

Je nach ADO.NET Anbieter kann die Reihenfolge der Parameter in der SelectParameters Auflistung wichtig sein. Die System.Data.OleDb und System.Data.Odbc Anbieter zuordnen die Parameter in der Auflistung entsprechend der Reihenfolge, in der die Parameter in der parameterisierten SQL Abfrage angezeigt werden. Der System.Data.SqlClient Anbieter, der der Standard-ADO.NET anbieter für das Steuerelement ist, ordnet die Parameter in der Auflistung mit dem Namen des Parameters mit einem Platzhalter-Alias in der SqlDataSource SQL-Abfrage überein. Weitere Informationen zu parameterisierten SQL Abfragen und Befehlen finden Sie unter Verwenden von Parametern mit dem SqlDataSource-Steuerelement.

Gilt für

Siehe auch