ControlParameter Constructores
Definición
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
| 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, 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, 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, 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, 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. |
ControlParameter()
Inicializa una nueva instancia sin nombre de la ControlParameter clase .
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.ObjectInputen y la DefaultValue propiedad se inicializa en null.
Se aplica a
ControlParameter(ControlParameter)
Inicializa una nueva instancia de la ControlParameter clase con 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 ControlParameter desde la que se inicializa la instancia actual.
Comentarios
El ControlParameter constructor es un constructor de copia protegido que se usa para clonar una ControlParameter instancia. Los valores del ControlParameter objeto, incluidas las ControlIDpropiedades , PropertyName, Namey Type , se transfieren a la nueva instancia.
Consulte también
Se aplica a
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.
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.
- controlID
- String
Nombre del control al que está enlazado el parámetro. El valor predeterminado 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 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.
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.
- controlID
- String
Nombre del control al que está enlazado el parámetro. El valor predeterminado es Empty.
- propertyName
- String
Nombre de la propiedad en el control al que está enlazado el parámetro. El valor predeterminado 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 controles para escribir datos en una base de datos desde una página de Formularios 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 ControlParameter clase mediante 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
Nombre del parámetro.
- dbType
- DbType
Tipo de datos del parámetro.
- controlID
- String
Nombre del control al que está enlazado el parámetro. El valor predeterminado es Empty.
- propertyName
- String
Nombre de la propiedad del control al que está enlazado el parámetro. El valor predeterminado es Empty.
Se aplica a
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.
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.
- controlID
- String
Nombre del control al que está enlazado el parámetro. El valor predeterminado es Empty.
- propertyName
- String
Nombre de la propiedad del control al que está enlazado el parámetro. El valor predeterminado 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 Typede parámetro, , Control nombre y PropertyName propiedad especificados. Solo las Direction propiedades y ConvertEmptyStringToNull se inicializan con valores predeterminados.