ControlParameter Construtores

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da ControlParameter classe.

Sobrecargas

Name	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 controlo especificado para identificar a que controlo se deve associar.
ControlParameter(String, String, String)	Inicializa uma nova instância nomeada da ControlParameter classe, usando o nome da propriedade e o nome de controlo especificados para identificar a que controlo deve ligar.
ControlParameter(String, DbType, String, String)	Inicializa uma nova instância da ControlParameter classe usando o nome do parâmetro especificado, tipo de base de dados, ID de controlo e nome da propriedade.
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 do controlo especificados para identificar a que controlo deve ser associado.

ControlParameter()

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

public:
 ControlParameter();

public ControlParameter();

Public Sub New ()

Exemplos

O código seguinte mostra como criar um ControlParameter objeto com o ControlParameter construtor. O ControlParameter objeto associa a SelectedValue propriedade de um DropDownList controlo a uma consulta SQL parametrizada que recupera dados que são exibidos num DataGrid controlo.

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

Observações

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 em 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 a partir da qual a instância atual é inicializada.

Observações

O ControlParameter construtor é um construtor de cópias protegidas que é usado para clonar uma ControlParameter instância. Os valores do ControlParameter objeto, incluindo os ControlID, PropertyName, Name, e Type as propriedades, são todos transferidos para a nova instância.

Ver também

Clone()

Aplica-se a

ControlParameter(String, String)

Inicializa uma nova instância nomeada da ControlParameter classe, usando o nome de controlo especificado para identificar a que controlo se deve 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 controlo ao qual o parâmetro está ligado. A predefinição é Empty.

Observações

Um ControlParameter objeto criado com o ControlParameter construtor é inicializado com o nome Control e nome do parâmetro especificados, que identificam o Control que o parâmetro se liga. Outras propriedades, incluindo PropertyName, Type, e Direction, são inicializadas com valores predefinidos.

Ver 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 controlo especificados para identificar a que controlo deve ligar.

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 controlo ao qual o parâmetro está ligado. A predefinição é Empty.

propertyName: String

O nome da propriedade no controlo ao qual o parâmetro está ligado. A predefinição é Empty.

Exemplos

O código seguinte mostra como criar ControlParameter objetos usando o ControlParameter construtor. Os parâmetros vinculam-se aos valores de TextBox e DropDownList controla para inserir dados numa base de dados a partir 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

Observações

Um ControlParameter objeto criado com o ControlParameter construtor é inicializado com o nome, Control nome e PropertyName propriedade especificados do parâmetro, que identificam o Control que o parâmetro liga. Outras propriedades, incluindo Type, Direction, e ConvertEmptyStringToNull, são inicializadas com valores predefinidos.

Ver também

Aplica-se a

ControlParameter(String, DbType, String, String)

Inicializa uma nova instância da ControlParameter classe usando o nome do parâmetro especificado, tipo de base de dados, ID de controlo e nome da propriedade.

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 controlo ao qual o parâmetro está ligado. A predefinição é Empty.

propertyName: String

O nome da propriedade do controlo ao qual o parâmetro está ligado. A predefiniçã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 do controlo especificados para identificar a que controlo deve ser associado.

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. A predefinição é Object.

controlID: String

O nome do controlo ao qual o parâmetro está ligado. A predefinição é Empty.

propertyName: String

O nome da propriedade do controlo ao qual o parâmetro está ligado. A predefinição é Empty.

Exemplos

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


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

Observações

Um ControlParameter objeto criado com o ControlParameter construtor é inicializado com o nome do parâmetro especificado, Type, Control nome e PropertyName propriedade. Apenas as Direction propriedades e ConvertEmptyStringToNull são inicializadas com valores predefinidos.

Ver também

Aplica-se a

Comentários

Esta página foi útil?