Partilhar via


ControlParameter Construtores

Definição

Inicializa uma nova instância da classe ControlParameter.

Sobrecargas

ControlParameter()

Inicializa uma nova instância não nomeada da classe ControlParameter.

ControlParameter(ControlParameter)

Inicializa uma nova instância da classe ControlParameter com os valores da instância especificada.

ControlParameter(String, String)

Inicializa uma nova instância nomeada da classe ControlParameter, usando o nome de controle especificado para identificar a qual controle associar.

ControlParameter(String, String, String)

Inicializa uma nova instância nomeada da classe ControlParameter, usando o nome de propriedade e o nome de controle especificados para identificar a qual controle associar.

ControlParameter(String, DbType, String, String)

Inicializa uma nova instância da classe ControlParameter usando o nome de parâmetro, o tipo de banco de dados, a ID de controle e o nome da propriedade especificados.

ControlParameter(String, TypeCode, String, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe ControlParameter, usando o nome de propriedade e o nome de controle especificados para identificar a qual controle associar.

ControlParameter()

Inicializa uma nova instância não nomeada da classe ControlParameter.

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

Exemplos

O código a seguir mostra como criar um ControlParameter objeto com o ControlParameter construtor . O ControlParameter objeto associa a SelectedValue propriedade de um DropDownList controle a uma consulta SQL parametrizada que recupera dados exibidos em um DataGrid controle.

<%@ 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>

Comentários

Um ControlParameter objeto criado com o ControlParameter construtor é inicializado com valores padrão para todas as suas propriedades. As ControlID propriedades e PropertyName são inicializadas para String.Empty. Além disso, a Name propriedade é inicializada como String.Empty, a Type propriedade é inicializada como TypeCode.Object, a Direction propriedade é inicializada como Inpute a DefaultValue propriedade é inicializada como null.

Aplica-se a

ControlParameter(ControlParameter)

Inicializa uma nova instância da classe ControlParameter com os valores da instância 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

Uma instância do ControlParameter na qual a instância atual é inicializada.

Comentários

O ControlParameter construtor é um construtor de cópia protegido usado para clonar uma ControlParameter instância. Os valores do ControlParameter objeto, incluindo as ControlIDpropriedades , PropertyName, Namee Type , são todos transferidos para a nova instância.

Confira também

Aplica-se a

ControlParameter(String, String)

Inicializa uma nova instância nomeada da classe ControlParameter, usando o nome de controle especificado para identificar a qual controle associar.

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

O nome do parâmetro.

controlID
String

O nome do controle ao qual o parâmetro está associado. O padrão é Empty.

Comentários

Um ControlParameter objeto criado com o ControlParameter construtor é inicializado com o nome e Control o nome do parâmetro especificados, que identifica o Control ao qual o parâmetro se associa. Outras propriedades, incluindo PropertyName, Typee Direction, são inicializadas com valores padrão.

Confira também

Aplica-se a

ControlParameter(String, String, String)

Inicializa uma nova instância nomeada da classe ControlParameter, usando o nome de propriedade e o nome de controle especificados para identificar a qual controle associar.

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

O nome do parâmetro.

controlID
String

O nome do controle ao qual o parâmetro está associado. O padrão é Empty.

propertyName
String

O nome da propriedade do controle ao qual o parâmetro está associado. O padrão é Empty.

Exemplos

O código a seguir mostra como criar ControlParameter objetos usando o ControlParameter construtor . Os parâmetros se associam aos valores de TextBox e DropDownList controles para inserir dados em um banco de dados de uma página 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

Comentários

Um ControlParameter objeto criado com o ControlParameter construtor é inicializado com o nome do parâmetro, Control o nome e PropertyName a propriedade especificados, que identifica o Control ao qual o parâmetro se associa. Outras propriedades, incluindo Type, Directione ConvertEmptyStringToNull, são inicializadas com valores padrão.

Confira também

Aplica-se a

ControlParameter(String, DbType, String, String)

Inicializa uma nova instância da classe ControlParameter usando o nome de parâmetro, o tipo de banco de dados, a ID de controle e o nome da propriedade 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

O nome do parâmetro.

dbType
DbType

O tipo de dados do parâmetro.

controlID
String

O nome do controle ao qual o parâmetro está associado. O padrão é Empty.

propertyName
String

O nome da propriedade do controle ao qual o parâmetro está associado. O padrão é Empty.

Aplica-se a

ControlParameter(String, TypeCode, String, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe ControlParameter, usando o nome de propriedade e o nome de controle especificados para identificar a qual controle associar.

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

O nome do parâmetro.

type
TypeCode

O tipo que o parâmetro representa. O padrão é Object.

controlID
String

O nome do controle ao qual o parâmetro está associado. O padrão é Empty.

propertyName
String

O nome da propriedade do controle ao qual o parâmetro está associado. O padrão é Empty.

Exemplos

O código a seguir mostra como usar o ControlParameter construtor para criar dois ControlParameter objetos e associá-los a um SqlDataSource controle .


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")

Comentários

Um ControlParameter objeto criado com o ControlParameter construtor é inicializado com o nome do parâmetro, , TypeControl nome e PropertyName propriedade especificados. Somente as Direction propriedades e ConvertEmptyStringToNull são inicializadas com valores padrão.

Confira também

Aplica-se a