ControlParameter Constructores

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í.

Inicializa una nueva instancia de la clase ControlParameter.

Sobrecargas

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, 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, 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, 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.

ControlParameter()

Inicializa una nueva instancia sin nombre de la clase ControlParameter.

public:
 ControlParameter();

public ControlParameter ();

Public Sub New ()

Ejemplos

En el código siguiente se muestra cómo crear un ControlParameter objeto con el ControlParameter constructor . El ControlParameter objeto enlaza la SelectedValue propiedad de un DropDownList control a una consulta SQL parametrizada que recupera los datos que se muestran en un DataGrid control .

<%@ Page Language="C#" CodeFile="param1acs.aspx.cs" Inherits="param1acs_aspx" %>
<!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">
    <div>
        <asp:DropDownList
          runat="server"
          AutoPostBack="True"
          id="DropDownList1">
            <asp:ListItem Value="USA">USA</asp:ListItem>
            <asp:ListItem Value="UK">UK</asp:ListItem>
         </asp:DropDownList>

        <asp:DataGrid
          runat="server"
          id="DataGrid1" />    
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="false" CodeFile="param1avb.aspx.vb" Inherits="param1avb_aspx" %>
<!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">
    <div>
        <asp:DropDownList
          runat="server"
          AutoPostBack="True"
          id="DropDownList1">
            <asp:ListItem Value="USA">USA</asp:ListItem>
            <asp:ListItem Value="UK">UK</asp:ListItem>
         </asp:DropDownList>

        <asp:DataGrid
          runat="server"
          id="DataGrid1" />    
    </div>
    </form>
</body>
</html>

Comentarios

Un ControlParameter objeto que se crea con el ControlParameter constructor se inicializa con valores predeterminados para todas sus propiedades. Las ControlID propiedades y PropertyName se inicializan en String.Empty. Además, la Name propiedad se inicializa en String.Empty, la Type propiedad se inicializa en , la Direction propiedad se inicializa TypeCode.Object Inputen y la DefaultValue propiedad se inicializa nullen .

Se aplica a

ControlParameter(ControlParameter)

Inicializa una nueva instancia de la clase ControlParameter con los valores de la instancia especificada.

protected:
 ControlParameter(System::Web::UI::WebControls::ControlParameter ^ original);

protected ControlParameter (System.Web.UI.WebControls.ControlParameter original);

new System.Web.UI.WebControls.ControlParameter : System.Web.UI.WebControls.ControlParameter -> System.Web.UI.WebControls.ControlParameter

Protected Sub New (original As ControlParameter)

Parámetros

original: ControlParameter

Instancia de ControlParameter a partir de la cual se inicializa la instancia actual.

Comentarios

El ControlParameter constructor es un constructor de copia protegido que se usa para clonar una ControlParameter instancia de . Los valores del ControlParameter objeto, incluidas las ControlIDpropiedades , PropertyName Name, y Type , se transfieren a la nueva instancia.

Consulte también

Clone()

Se aplica a

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.

public:
 ControlParameter(System::String ^ name, System::String ^ controlID);

public ControlParameter (string name, string controlID);

new System.Web.UI.WebControls.ControlParameter : string * string -> System.Web.UI.WebControls.ControlParameter

Public Sub New (name As String, controlID As String)

Parámetros

name: String

El nombre del parámetro.

controlID: String

El nombre del control al que está enlazado el parámetro. De manera predeterminada, es Empty.

Comentarios

Un ControlParameter objeto que se crea con el ControlParameter constructor se inicializa con el nombre y Control el nombre de parámetro especificados, que identifica al Control que se enlaza el parámetro. Otras propiedades, como PropertyName, Typey Direction, se inicializan con valores predeterminados.

Consulte también

Se aplica a

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.

public:
 ControlParameter(System::String ^ name, System::String ^ controlID, System::String ^ propertyName);

public ControlParameter (string name, string controlID, string propertyName);

new System.Web.UI.WebControls.ControlParameter : string * string * string -> System.Web.UI.WebControls.ControlParameter

Public Sub New (name As String, controlID As String, propertyName As String)

Parámetros

name: String

El nombre del parámetro.

controlID: String

El nombre del control al que está enlazado el parámetro. De manera predeterminada, es Empty.

propertyName: String

El nombre de la propiedad en el control al que se enlaza el parámetro. De manera predeterminada, es Empty.

Ejemplos

En el código siguiente se muestra cómo crear ControlParameter objetos mediante el ControlParameter constructor . Los parámetros se enlazan a los valores de TextBox y DropDownList los controles para escribir datos en una base de datos desde una página de Web Forms.

private void Button1_Click(object sender, EventArgs e) {

    // The user has pressed the Submit button, prepare a parameterized
    // SQL query to insert the values from the controls.
    AccessDataSource1.InsertCommand =
    "INSERT INTO Employees (FirstName,LastName,Address,City,PostalCode,Country,ReportsTo) " +
    "  VALUES (?,?,?,?,?,?,? ); ";

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("FirstName", "TextBox1", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("LastName", "TextBox2", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("Address", "TextBox3", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("City", "TextBox4", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("PostalCode", "TextBox5", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("Country", "TextBox6", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("ReportsTo", "DropDownList1", "SelectedValue"));

    try {
        AccessDataSource1.Insert();
    }
    finally {
        Button1.Visible = false;
        Label9.Visible = true;
    }
}

Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

    ' The user has pressed the Submit button, prepare a parameterized
    ' SQL query to insert the values from the controls.
    AccessDataSource1.InsertCommand = _
    "INSERT INTO Employees (FirstName,LastName,Address,City,PostalCode,Country,ReportsTo) " & _
    "  VALUES (?,?,?,?,?,?,? ); "

    Dim firstName As New ControlParameter("FirstName", "TextBox1", "Text")
    AccessDataSource1.InsertParameters.Add(firstName)

    Dim lastName As New ControlParameter("LastName", "TextBox2", "Text")
    AccessDataSource1.InsertParameters.Add(lastName)

    Dim address As New ControlParameter("Address", "TextBox3", "Text")
    AccessDataSource1.InsertParameters.Add(address)

    Dim city As New ControlParameter("City", "TextBox4", "Text")
    AccessDataSource1.InsertParameters.Add(city)

    Dim postalCode As New ControlParameter("PostalCode", "TextBox5", "Text")
    AccessDataSource1.InsertParameters.Add(postalCode)

    Dim country As New ControlParameter("Country", "TextBox6", "Text")
    AccessDataSource1.InsertParameters.Add(country)

    Dim supervisor As New ControlParameter("ReportsTo", "DropDownList1", "SelectedValue")
    AccessDataSource1.InsertParameters.Add(supervisor)

    Try
        AccessDataSource1.Insert()
    Finally
        Button1.Visible = False
        Label9.Visible = True
    End Try

End Sub

Comentarios

Un ControlParameter objeto que se crea con el ControlParameter constructor se inicializa con el nombre de parámetro, Control el nombre y PropertyName la propiedad especificados, que identifica al Control que se enlaza el parámetro. Otras propiedades, como Type, Directiony ConvertEmptyStringToNull, se inicializan con valores predeterminados.

Consulte también

Se aplica a

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.

public:
 ControlParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ controlID, System::String ^ propertyName);

public ControlParameter (string name, System.Data.DbType dbType, string controlID, string propertyName);

new System.Web.UI.WebControls.ControlParameter : string * System.Data.DbType * string * string -> System.Web.UI.WebControls.ControlParameter

Public Sub New (name As String, dbType As DbType, controlID As String, propertyName As String)

Parámetros

name: String

El nombre del parámetro.

dbType: DbType

El tipo de datos del parámetro.

controlID: String

El nombre del control al que está enlazado el parámetro. De manera predeterminada, es Empty.

propertyName: String

Nombre de la propiedad del control al que se enlaza el parámetro. De manera predeterminada, es Empty.

Se aplica a

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.

public:
 ControlParameter(System::String ^ name, TypeCode type, System::String ^ controlID, System::String ^ propertyName);

public ControlParameter (string name, TypeCode type, string controlID, string propertyName);

new System.Web.UI.WebControls.ControlParameter : string * TypeCode * string * string -> System.Web.UI.WebControls.ControlParameter

Public Sub New (name As String, type As TypeCode, controlID As String, propertyName As String)

Parámetros

name: String

El nombre del parámetro.

type: TypeCode

Tipo que el parámetro representa. De manera predeterminada, es Object.

controlID: String

El nombre del control al que está enlazado el parámetro. De manera predeterminada, es Empty.

propertyName: String

Nombre de la propiedad del control al que se enlaza el parámetro. De manera predeterminada, es Empty.

Ejemplos

En el código siguiente se muestra cómo usar el ControlParameter constructor para crear dos ControlParameter objetos y asociarlos a un SqlDataSource control .


ControlParameter country =
  new ControlParameter("country",TypeCode.String,"ListBox1","SelectedValue");
sqlSource.SelectParameters.Add(country);

ControlParameter report  =
  new ControlParameter("report",TypeCode.Int16,"ListBox2","SelectedValue");
sqlSource.SelectParameters.Add(report);


Dim country As ControlParameter
country = New ControlParameter("country", TypeCode.String, "ListBox1", "SelectedValue")

Dim report As ControlParameter
report = New ControlParameter("report", TypeCode.Int16, "ListBox2", "SelectedValue")

Comentarios

Un ControlParameter objeto que se crea con el ControlParameter constructor se inicializa con el nombre de parámetro, Type, Control el nombre y PropertyName la propiedad especificados. Solo las Direction propiedades y ConvertEmptyStringToNull se inicializan con valores predeterminados.

Consulte también

Se aplica a

ControlParameter Constructores

Definición

Sobrecargas

ControlParameter()

Ejemplos

Comentarios

Se aplica a

ControlParameter(ControlParameter)

Parámetros

Comentarios

Consulte también

Se aplica a

ControlParameter(String, String)

Parámetros

Comentarios

Consulte también

Se aplica a

ControlParameter(String, String, String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

ControlParameter(String, DbType, String, String)

Parámetros

Se aplica a

ControlParameter(String, TypeCode, String, String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Comentarios

Recursos adicionales