ControlParameter Classe

Definição

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

Vincula o valor de uma propriedade de a Control a um objeto de parâmetro.

public ref class ControlParameter : System::Web::UI::WebControls::Parameter
public class ControlParameter : System.Web.UI.WebControls.Parameter
type ControlParameter = class
    inherit Parameter
Public Class ControlParameter
Inherits Parameter
Herança
Object
Parameter
ControlParameter

Exemplos

O exemplo de código seguinte demonstra como usar um ControlParameter objeto para vincular dados exibidos num ListBox controlo ao valor selecionado de um DropDownList controlo num cenário declarativo. O ControlParameter objeto é adicionado à SelectParameters coleção do SqlDataSource controlo no formulário e corresponde ao texto "@Title" provisório na SelectCommand propriedade.

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

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

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

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

Observações

Pode usar a ControlParameter classe para associar o valor de uma Control propriedade, como SelectedValue ou SelectedIndex, a um parâmetro usado numa consulta SQL parametrizada, método de objeto de negócio ou expressão de filtragem.

A ControlParameter classe fornece duas propriedades além das herdadas da Parameter classe: ControlID e PropertyName. A ControlID propriedade identifica a que Control instância se deve ligar e a PropertyName propriedade identifica a propriedade pública da Control qual a ControlParameter classe recupera um valor.

Construtores

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, 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, 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, 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, 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.

Propriedades

Name Description
ControlID

Especifica o nome do controlo ao qual o ControlParameter objeto se liga.
ConvertEmptyStringToNull

Obtém ou define um valor que indica se o valor ao qual o Parameter objeto está ligado deve ser convertido se null for Empty.

(Herdado de Parameter)
DbType

Obtém ou define o tipo de base de dados do parâmetro.

(Herdado de Parameter)
DefaultValue

Especifica um valor por defeito para o parâmetro, caso o valor que o parâmetro está vinculado a ser não inicializado quando o Evaluate(HttpContext, Control) método for chamado.

(Herdado de Parameter)
Direction

Indica se o Parameter objeto é usado para associar um valor a um controlo, ou se o controlo pode ser usado para alterar o valor.

(Herdado de Parameter)
IsTrackingViewState

Recebe um valor que indica se o Parameter objeto está a guardar alterações ao seu estado de visualização.

(Herdado de Parameter)
Name

Obtém ou define o nome do parâmetro.

(Herdado de Parameter)
PropertyName

Obtém ou define o nome da propriedade do controlo identificado pela ControlID propriedade à qual o ControlParameter objeto se liga.
Size

Obtém ou define o tamanho do parâmetro.

(Herdado de Parameter)
Type

Obtém ou define o tipo do parâmetro.

(Herdado de Parameter)
ViewState

Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um Parameter objeto através de múltiplos pedidos para a mesma página.

(Herdado de Parameter)

Métodos

Name Description
Clone()

Devolve um duplicado da instância atual ControlParameter .
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Evaluate(HttpContext, Control)

Atualiza e devolve o valor do ControlParameter objeto.
GetDatabaseType()

Obtém o DbType valor equivalente ao tipo CLR da instância atual Parameter .

(Herdado de Parameter)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
LoadViewState(Object)

Restaura o estado da vista de fonte de dados anteriormente guardada.

(Herdado de Parameter)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnParameterChanged()

Chama o OnParametersChanged(EventArgs) método da ParameterCollection coleção que contém o Parameter objeto.

(Herdado de Parameter)
SaveViewState()

Guarda as alterações ao estado de Parameter visualização do objeto desde o momento em que a página foi publicada de volta no servidor.

(Herdado de Parameter)
SetDirty()

Marca o Parameter objeto para que o seu estado fique registado no estado de visualização.

(Herdado de Parameter)
ToString()

Converte o valor desta instância para a sua representação equivalente da cadeia.

(Herdado de Parameter)
TrackViewState()

Faz com que o Parameter objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do ViewState controlo e persistidas entre pedidos para a mesma página.

(Herdado de Parameter)

Implementações de Interface Explícita

Name Description
ICloneable.Clone()

Devolve um duplicado da instância atual Parameter .

(Herdado de Parameter)
IStateManager.IsTrackingViewState

Recebe um valor que indica se o Parameter objeto está a guardar alterações ao seu estado de visualização.

(Herdado de Parameter)
IStateManager.LoadViewState(Object)

Restaura o estado da vista de fonte de dados anteriormente guardada.

(Herdado de Parameter)
IStateManager.SaveViewState()

Guarda as alterações ao estado de Parameter visualização do objeto desde o momento em que a página foi publicada de volta no servidor.

(Herdado de Parameter)
IStateManager.TrackViewState()

Faz com que o Parameter objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do ViewState controlo e persistidas entre pedidos para a mesma página.

(Herdado de Parameter)

Aplica-se a

Ver também