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
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.ObjectInputen y la DefaultValue propiedad se inicializa null
en .
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 , PropertyNameName, y Type , se transfieren a la nueva instancia.
Consulte también
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.
- 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.