ControlParameter Clase

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 a Control 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 con parámetros, 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 la clase desde la Control que la ControlParameter clase recupera un valor.

Constructores

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

Propiedades

Nombre	Description
ControlID	Especifica el nombre del control al que se enlaza el ControlParameter objeto.
ConvertEmptyStringToNull	Obtiene o establece un valor que indica si el valor al que está enlazado el Parameter objeto se debe convertir `null` en 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 del parámetro está enlazado a no inicializarse cuando se llama al Evaluate(HttpContext, Control) método . (Heredado de Parameter)
Direction	Indica si el Parameter objeto se usa para enlazar un valor a un control o el control se puede usar para cambiar el valor. (Heredado de Parameter)
IsTrackingViewState	Obtiene un valor que indica si el Parameter objeto guarda 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 ControlID propiedad a la que se enlaza el ControlParameter objeto.
Size	Obtiene o establece el tamaño del parámetro . (Heredado de Parameter)
Type	Obtiene o establece el tipo del parámetro . (Heredado de Parameter)
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un Parameter objeto en varias solicitudes para la misma página. (Heredado de Parameter)

Métodos

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

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Devuelve un duplicado de la instancia actual Parameter . (Heredado de Parameter)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el Parameter objeto guarda los cambios en su estado de vista. (Heredado de Parameter)
IStateManager.LoadViewState(Object)	Restaura el estado de vista guardado previamente de la vista del origen de datos. (Heredado de Parameter)
IStateManager.SaveViewState()	Guarda los cambios en el Parameter estado de vista del objeto desde el momento en que se devolvió la página al servidor. (Heredado de Parameter)
IStateManager.TrackViewState()	Hace que el Parameter objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en el objeto del ViewState control y conservarse en las solicitudes de la misma página. (Heredado de Parameter)

Se aplica a

Consulte también

Comentarios

Resultoulle útil esta páxina?

Compartir por

ControlParameter Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios