Questa documentazione è stata archiviata e non viene gestita.

Proprietà SqlDataSource.SelectParameters

Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà SelectCommand dall'oggetto SqlDataSourceView associato al controllo SqlDataSource.

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public ParameterCollection SelectParameters { get; }
/** @property */
public ParameterCollection get_SelectParameters ()

public function get SelectParameters () : ParameterCollection

Non applicabile.

Valore proprietà

Oggetto ParameterCollection contenente i parametri utilizzati dalla proprietà SelectCommand.

Se la proprietà SelectCommand contiene una query SQL con parametri, l'insieme SelectParameters contiene gli oggetti Parameter corrispondenti ai segnaposto di parametro presenti nella stringa SQL.

NotaNota:

Se non si ha dimestichezza con le funzioni di accesso ai dati in ASP.NET 2.0, è consigliabile leggere uno o più dei seguenti argomenti prima di continuare:

A seconda del provider ADO.NET, l'ordine dei parametri nell'insieme SelectParameters può essere importante. I provider System.Data.OleDb e System.Data.Odbc associano i parametri nell'insieme secondo l'ordine in cui compaiono nella query SQL con parametri. Il provider System.Data.SqlClient, vale a dire il provider ADO.NET predefinito per il controllo SqlDataSource, associa i parametri nell'insieme stabilendo una corrispondenza tra il nome del parametro e un alias di segnaposto nella query SQL. Per ulteriori informazioni su comandi e query SQL con parametri, vedere Utilizzo dei parametri con il controllo SqlDataSource.

La proprietà SelectParameters recupera la proprietà SelectParameters contenuta nell'oggetto SqlDataSourceView associato al controllo T:System.Web.UI.WebControls.SqlDataSource.

Nota sulla sicurezzaNota: sulla protezione

I valori vengono inseriti nei parametri senza convalida rappresentando un potenziale rischio per la sicurezza. Utilizzare l'evento Selecting per convalidare i valori dei parametri prima di eseguire la query. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script.

Nell'esempio di codice riportato di seguito viene illustrato come recuperare dati dal database di Northwind in Microsoft SQL Server impostando la proprietà SelectCommand su una query SQL. La query SQL è con parametri e il segnaposto nella proprietà SelectCommand corrisponde all'oggetto ControlParameter aggiunto all'insieme SelectParameters. Il controllo DropDownList, cui è associato ControlParameter, funge da filtro per quanto visualizzato nel controllo ListBox.

NotaNota:

Dal momento che il parametro è utilizzato in una clausola WHERE, l'utilizzo della proprietà SelectParameters nel codice di esempio è equivalente sotto il profilo funzionale all'utilizzo delle proprietà FilterExpression e 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="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 Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:
Mostra: