ControlParameter Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Enlaza el valor de una propiedad de un elemento Control a un objeto de parámetro.

public ref class ControlParameter : System::Web::UI::WebControls::Parameter

public class ControlParameter : System.Web.UI.WebControls.Parameter

type ControlParameter = class
    inherit Parameter

Public Class ControlParameter
Inherits Parameter

Herencia: Object

Parameter
ControlParameter

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un ControlParameter objeto para enlazar datos mostrados en un ListBox control al valor seleccionado de un DropDownList control en un escenario declarativo. El ControlParameter objeto se agrega a la SelectParameters colección del SqlDataSource control del formulario y corresponde al texto del marcador de posición "@Title" de la SelectCommand propiedad .

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

Comentarios

Puede usar la ControlParameter clase para enlazar el valor de una Control propiedad, como SelectedValue o SelectedIndex, a un parámetro que se usa en una consulta SQL parametrizada, un método de objeto de negocio o una expresión de filtrado.

La ControlParameter clase proporciona dos propiedades además de las heredadas de la Parameter clase : ControlID y PropertyName. La ControlID propiedad identifica a qué Control instancia se va a enlazar y la PropertyName propiedad identifica la propiedad pública de desde la Control que la ControlParameter clase recupera un valor.

Constructores

ControlParameter()	Inicializa una nueva instancia sin nombre de la clase ControlParameter.
ControlParameter(ControlParameter)	Inicializa una nueva instancia de la clase ControlParameter con los valores de la instancia especificada.
ControlParameter(String, DbType, String, String)	Inicializa una nueva instancia de la clase ControlParameter con el nombre de parámetro, el tipo de base de datos, el identificador de control y el nombre de propiedad especificados.
ControlParameter(String, String)	Inicializa una instancia nueva con nombre de la clase ControlParameter, utilizando el nombre de control especificado para identificar a qué campo se realiza el enlace.
ControlParameter(String, String, String)	Inicializa una instancia con nombre nueva de la clase ControlParameter, utilizando el nombre de la propiedad y el control especificados para identificar a qué control se realiza el enlace.
ControlParameter(String, TypeCode, String, String)	Inicializa una instancia con nombre nueva y fuertemente tipada de la clase ControlParameter, utilizando el nombre de la propiedad y el control especificados para identificar a qué control se realiza el enlace.

Propiedades

ControlID	Especifica el nombre del control al que se enlaza el objeto ControlParameter.
ConvertEmptyStringToNull	Obtiene o establece un valor que indica si el valor al que está enlazado el objeto Parameter debe convertirse a `null` si es Empty. (Heredado de Parameter)
DbType	Obtiene o establece el tipo de base de datos del parámetro. (Heredado de Parameter)
DefaultValue	Especifica un valor predeterminado para el parámetro, si el valor al que está enlazado el parámetro no debe estar inicializado cuando se llame al método Evaluate(HttpContext, Control). (Heredado de Parameter)
Direction	Indica si el objeto Parameter se utiliza para enlazar un valor a un control o si se puede utilizar el control para cambiar el valor. (Heredado de Parameter)
IsTrackingViewState	Obtiene un valor que indica si el objeto Parameter está guardando los cambios en su estado de vista. (Heredado de Parameter)
Name	Obtiene o establece el nombre del parámetro. (Heredado de Parameter)
PropertyName	Obtiene o establece el nombre de propiedad del control identificado por la propiedad ControlID al que se enlaza el objeto ControlParameter.
Size	Obtiene o establece el tamaño del parámetro. (Heredado de Parameter)
Type	Obtiene o establece el tipo de parámetro. (Heredado de Parameter)
ViewState	Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto Parameter en las distintas solicitudes de la misma página. (Heredado de Parameter)

Métodos

Clone()	Devuelve un duplicado de la instancia ControlParameter actual.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Evaluate(HttpContext, Control)	Actualiza y devuelve el valor del objeto ControlParameter.
GetDatabaseType()	Obtiene el valor DbType que es equivalente al tipo CLR de la instancia Parameter actual. (Heredado de Parameter)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
LoadViewState(Object)	Restaura la vista del origen de datos tal y como se guardó previamente. (Heredado de Parameter)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnParameterChanged()	Llama al método OnParametersChanged(EventArgs) de la colección ParameterCollection que contiene el objeto Parameter. (Heredado de Parameter)
SaveViewState()	Guarda los cambios realizados en el estado de la vista del objeto Parameter desde el momento en que se devolvió la página al servidor. (Heredado de Parameter)
SetDirty()	Marca el objeto Parameter para que su estado se registre en el estado de vista. (Heredado de Parameter)
ToString()	Convierte el valor de esta instancia en la representación de cadena equivalente. (Heredado de Parameter)
TrackViewState()	Hace que el objeto Parameter realice el seguimiento de los cambios en su estado de vista, de modo que puedan almacenarse en el objeto ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de Parameter)

Implementaciones de interfaz explícitas

ICloneable.Clone()	Devuelve un duplicado de la instancia Parameter actual. (Heredado de Parameter)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el objeto Parameter está guardando los cambios en su estado de vista. (Heredado de Parameter)
IStateManager.LoadViewState(Object)	Restaura la vista del origen de datos tal y como se guardó previamente. (Heredado de Parameter)
IStateManager.SaveViewState()	Guarda los cambios realizados en el estado de la vista del objeto Parameter desde el momento en que se devolvió la página al servidor. (Heredado de Parameter)
IStateManager.TrackViewState()	Hace que el objeto Parameter realice el seguimiento de los cambios en su estado de vista, de modo que puedan almacenarse en el objeto ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de Parameter)

Se aplica a

Compartir vía