ControlParameter Construtores

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Clone()

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, , Type Control nome e PropertyName propriedade especificados. Somente as Direction propriedades e ConvertEmptyStringToNull são inicializadas com valores padrão.

Confira também

Aplica-se a

Compartilhar via

ControlParameter Construtores

Definição

Sobrecargas

ControlParameter()

Exemplos

Comentários

Aplica-se a

ControlParameter(ControlParameter)

Parâmetros

Comentários

Confira também

Aplica-se a

ControlParameter(String, String)

Parâmetros

Comentários

Confira também

Aplica-se a

ControlParameter(String, String, String)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

ControlParameter(String, DbType, String, String)

Parâmetros

Aplica-se a

ControlParameter(String, TypeCode, String, String)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais