SqlDataSource.SelectParameters (Propiedad)
Ensamblado: System.Web (en system.web.dll)
/** @property */ public ParameterCollection get_SelectParameters ()
public function get SelectParameters () : ParameterCollection
No aplicable.
Valor de propiedad
ParameterCollection que contiene los parámetros utilizados por la propiedad SelectCommand.Si la propiedad SelectCommand contiene una consulta SQL parametrizada, la colección SelectParameters contiene los objetos Parameter que corresponden a los marcadores de posición de los parámetros en la cadena SQL.
Nota: |
|---|
| Si no conoce las características de acceso a datos de ASP.NET 2.0, lea uno o varios de los temas siguientes antes de continuar: |
Dependiendo del proveedor de ADO.NET, el orden de los parámetros en la colección SelectParameters podría ser importante. Los proveedores System.Data.OleDb y System.Data.Odbc asocian los parámetros de la colección en función del orden en que aparecen en la consulta SQL parametrizada. El proveedor System.Data.SqlClient, que es el proveedor ADO.NET predeterminado para el control SqlDataSource, asocia los parámetros de la colección comparando el nombre del parámetro con el alias de un marcador de posición en la consulta SQL. Para obtener más información sobre las consultas y comandos parametrizados de SQL, vea Utilizar parámetros con el control SqlDataSource.
La propiedad SelectParameters recupera la propiedad SelectParameters que está contenida en el objeto SqlDataSourceView asociado al control T:System.Web.UI.WebControls.SqlDataSource.
Nota: de seguridad |
|---|
| Los valores se insertan en parámetros sin validación, lo que puede suponer una amenaza para la seguridad. Utilice el evento Selecting para validar los valores de los parámetros antes de ejecutar la consulta. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos. |
En el siguiente ejemplo de código se muestra cómo recuperar datos de la base de datos Northwind en Microsoft SQL Server estableciendo la propiedad SelectCommand en una consulta SQL. La consulta SQL se parametriza y el marcador de la propiedad SelectCommand se compara con el objeto ControlParameter que se agrega a la colección SelectParameters. El control DropDownList, al que se enlaza ControlParameter, actúa como un filtro para lo que se muestra en el control ListBox.
Nota: |
|---|
| Dado que el parámetro se utiliza en una cláusula WHERE, el uso de la propiedad SelectParameters en el ejemplo de código es funcionalmente equivalente al uso de las propiedades FilterExpression y 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 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.Referencia
SqlDataSource (Clase)SqlDataSource (Miembros)
System.Web.UI.WebControls (Espacio de nombres)
SqlDataSource.SelectCommand (Propiedad)
Select
Otros recursos
Información general sobre el acceso a datos en ASP.NETLo nuevo en el acceso a datos de ASP.NET
Controles de servidor Web de orígenes de datos
SqlDataSource (Control de servidor Web)
Información general sobre el ciclo de vida de una página ASP.NET
Nota: