ControlParameter Construtores

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

Nome	Description
ControlParameter()	Inicializa uma nova instância sem nome da ControlParameter classe.
ControlParameter(ControlParameter)	Inicializa uma nova instância da ControlParameter classe com valores da instância especificada.
ControlParameter(String, String)	Inicializa uma nova instância nomeada da ControlParameter classe, usando o nome de controle especificado para identificar a qual controle associar.
ControlParameter(String, String, String)	Inicializa uma nova instância nomeada da ControlParameter classe, usando o nome da propriedade e o nome de controle especificados para identificar a qual controle associar.
ControlParameter(String, DbType, String, String)	Inicializa uma nova instância da ControlParameter classe usando o nome do 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 ControlParameter classe, usando o nome da propriedade e o nome de controle especificados para identificar a qual controle associar.

ControlParameter()

Inicializa uma nova instância sem nome da ControlParameter classe.

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 as PropertyName propriedades são inicializadas para String.Empty. Além disso, a Name propriedade é inicializada para String.Empty, a Type propriedade é inicializada para TypeCode.Object, a Direction propriedade é inicializada para Input, e a DefaultValue propriedade é inicializada para null.

Aplica-se a

ControlParameter(ControlParameter)

Inicializa uma nova instância da ControlParameter classe com 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 ControlParameter instância da qual a instância atual é inicializada.

Comentários

O ControlParameter construtor é um construtor de cópia protegido que é usado para clonar uma ControlParameter instância. Os valores do ControlParameter objeto, incluindo o ControlID, PropertyNamee Name Type as propriedades, 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 ControlParameter classe, 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 parâmetro 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 ControlParameter classe, usando o nome da 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 no 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 e DropDownList controles TextBox para inserir dados em um banco de dados de uma página do 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 parâmetro 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 ControlParameter classe usando o nome do 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 ControlParameter classe, usando o nome da 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, o Type Control nome e PropertyName a propriedade especificados. Somente as propriedades e ConvertEmptyStringToNull as Direction propriedades são inicializadas com valores padrão.

Confira também

Aplica-se a

Comentários

Esta página foi útil?

Partilhar 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

Comentários