Proprietà SqlDataSource.SelectParameters
Assembly: System.Web (in system.web.dll)
/** @property */ public ParameterCollection get_SelectParameters ()
public function get SelectParameters () : ParameterCollection
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.
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 dall'oggetto SqlDataSourceView associato al controllo SqlDataSource.
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.
 Nota |
|---|
| 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> <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 non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.
