ControlParameter Constructores

Definición

Inicializa una nueva instancia de la clase ControlParameter.Initializes a new instance of the ControlParameter class.

Sobrecargas

ControlParameter()

Inicializa una nueva instancia sin nombre de la clase ControlParameter.Initializes a new unnamed instance of the ControlParameter class.

ControlParameter(ControlParameter)

Inicializa una nueva instancia de la clase ControlParameter con los valores de la instancia especificada.Initializes a new instance of the ControlParameter class with values from the specified instance.

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.Initializes a new named instance of the ControlParameter class, using the specified control name to identify which control to bind to.

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.Initializes a new named instance of the ControlParameter class, using the specified property name and control name to identify which control to bind to.

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.Initializes a new instance of the ControlParameter class by using the specified parameter name, database type, control ID, and property name.

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.Initializes a new named and strongly typed instance of the ControlParameter class, using the specified property name and control name to identify which control to bind to.

ControlParameter()

Inicializa una nueva instancia sin nombre de la clase ControlParameter.Initializes a new unnamed instance of the ControlParameter class.

public:
 ControlParameter();
public ControlParameter ();
Public Sub New ()

Ejemplos

En el código siguiente se muestra cómo crear ControlParameter un objeto con ControlParameter el constructor.The following code shows how to create a ControlParameter object with the ControlParameter constructor. El ControlParameter objeto enlaza la propiedad SelectedValue de un DropDownList control a una consulta SQL parametrizada que recupera los datos que se muestran en un DataGrid control.The ControlParameter object binds the SelectedValue property of a DropDownList control to a parameterized SQL query that retrieves data that is displayed in a 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 los valores predeterminados para todas sus propiedades.A ControlParameter object that is created with the ControlParameter constructor is initialized with default values for all its properties. Las ControlID propiedades PropertyName y se inicializan en String.Empty.The ControlID and PropertyName properties are initialized to String.Empty. Además, Name la propiedad se inicializa String.Emptyen, la Type propiedad se inicializa en TypeCode.Object, la Direction propiedad se inicializa en Inputy la DefaultValue propiedad se inicializa en. null.In addition, the Name property is initialized to String.Empty, the Type property is initialized to TypeCode.Object, the Direction property is initialized to Input, and the DefaultValue property is initialized to null.

ControlParameter(ControlParameter)

Inicializa una nueva instancia de la clase ControlParameter con los valores de la instancia especificada.Initializes a new instance of the ControlParameter class with values from the specified instance.

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.A ControlParameter instance from which the current instance is initialized.

Comentarios

El ControlParameter constructor es un constructor de copias protegido que se utiliza para clonar una instancia de ControlParameter .The ControlParameter constructor is a protected copy constructor that is used to clone a ControlParameter instance. Los valores del ControlParameter objeto, incluidas Type las ControlIDpropiedades, PropertyName, Namey, se transfieren a la nueva instancia.The values of the ControlParameter object, including the ControlID, PropertyName, Name, and Type properties, are all transferred to the new instance.

Consulte también:

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.Initializes a new named instance of the ControlParameter class, using the specified control name to identify which control to bind to.

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

Nombre del parámetro.The name of the parameter.

controlID
String

El nombre del control al que está enlazado el parámetro.The name of the control that the parameter is bound to. De manera predeterminada, es Empty.The default is Empty.

Comentarios

Un ControlParameter objeto que se crea con el ControlParameter constructor se inicializa con el nombre de parámetro y Control el nombre especificados, que Control identifica el objeto al que se enlaza el parámetro.A ControlParameter object that is created with the ControlParameter constructor is initialized with the specified parameter name and Control name, which identifies the Control that the parameter binds to. Otras propiedades, como PropertyName, Typey Direction, se inicializan con los valores predeterminados.Other properties, including PropertyName, Type, and Direction, are initialized with default values.

Consulte también:

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.Initializes a new named instance of the ControlParameter class, using the specified property name and control name to identify which control to bind to.

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

Nombre del parámetro.The name of the parameter.

controlID
String

El nombre del control al que está enlazado el parámetro.The name of the control that the parameter is bound to. De manera predeterminada, es Empty.The default is Empty.

propertyName
String

El nombre de la propiedad en el control al que se enlaza el parámetro.The name of the property on the control that the parameter is bound to. De manera predeterminada, es Empty.The default is Empty.

Ejemplos

En el código siguiente se muestra cómo ControlParameter crear objetos mediante el ControlParameter constructor.The following code shows how to create ControlParameter objects by using the ControlParameter constructor. Los parámetros se enlazan a los TextBox valores DropDownList de los controles y para especificar datos en una base de datos desde una página de formularios Web Forms.The parameters bind to the values of TextBox and DropDownList controls to enter data in a database from a Web Forms page.

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 Control identifica el objeto al que se enlaza el parámetro.A ControlParameter object that is created with the ControlParameter constructor is initialized with the specified parameter name, Control name, and PropertyName property, which identifies the Control that the parameter binds to. Otras propiedades, como Type, Directiony ConvertEmptyStringToNull, se inicializan con los valores predeterminados.Other properties, including Type, Direction, and ConvertEmptyStringToNull, are initialized with default values.

Consulte también:

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.Initializes a new instance of the ControlParameter class by using the specified parameter name, database type, control ID, and property name.

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

Parámetros

name
String

Nombre del parámetro.The name of the parameter.

dbType
DbType

Tipo de datos del parámetro.The data type of the parameter.

controlID
String

El nombre del control al que está enlazado el parámetro.The name of the control that the parameter is bound to. De manera predeterminada, es Empty.The default is Empty.

propertyName
String

Nombre de la propiedad del control al que se enlaza el parámetro.The name of the property of the control that the parameter is bound to. De manera predeterminada, es Empty.The default is Empty.

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.Initializes a new named and strongly typed instance of the ControlParameter class, using the specified property name and control name to identify which control to bind to.

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

Nombre del parámetro.The name of the parameter.

type
TypeCode

Tipo que el parámetro representa.The type that the parameter represents. De manera predeterminada, es Object.The default is Object.

controlID
String

El nombre del control al que está enlazado el parámetro.The name of the control that the parameter is bound to. De manera predeterminada, es Empty.The default is Empty.

propertyName
String

Nombre de la propiedad del control al que se enlaza el parámetro.The name of the property of the control that the parameter is bound to. De manera predeterminada, es Empty.The default is Empty.

Ejemplos

En el código siguiente se muestra cómo utilizar ControlParameter el constructor para crear ControlParameter dos objetos y asociarlos a SqlDataSource un control.The following code shows how to use the ControlParameter constructor to create two ControlParameter objects and associate them with a 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, Typeel Control nombre y PropertyName la propiedad especificados.A ControlParameter object that is created with the ControlParameter constructor is initialized with the specified parameter name, Type, Control name, and PropertyName property. Solo las Direction propiedades ConvertEmptyStringToNull y se inicializan con los valores predeterminados.Only the Direction and ConvertEmptyStringToNull properties are initialized with default values.

Consulte también:

Se aplica a