ControlParameter Classe

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.

Associa o valor de uma propriedade de um 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 a seguir demonstra como usar um ControlParameter objeto para associar dados exibidos em um ListBox controle ao valor selecionado de um DropDownList controle em um cenário declarativo. O ControlParameter objeto é adicionado à SelectParameters coleção do SqlDataSource controle no formulário e corresponde ao texto de espaço reservado "@Title" 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>

Comentários

Você pode usar a ControlParameter classe para associar o valor de uma Control propriedade, como SelectedValue ou SelectedIndex, a um parâmetro usado em uma consulta SQL parametrizada, método de objeto empresarial 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 qual Control instância associar e a PropertyName propriedade identifica a propriedade pública da Control qual a ControlParameter classe recupera um valor.

Construtores

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

Propriedades

ControlID	Especifica o nome do controle ao qual o objeto ControlParameter é associado.
ConvertEmptyStringToNull	Obtém ou define um valor que indica se o valor ao qual o objeto Parameter está associado deverá ser convertido em `null` se ele for Empty. (Herdado de Parameter)
DbType	Obtém ou define o tipo de banco de dados do parâmetro. (Herdado de Parameter)
DefaultValue	Especifica um valor padrão para o parâmetro, caso o valor a que o parâmetro esteja associado não devesse ser inicializado quando o método Evaluate(HttpContext, Control) for chamado. (Herdado de Parameter)
Direction	Indica se o objeto Parameter é usado para associar um valor a um controle ou o controle pode ser usado para alterar o valor. (Herdado de Parameter)
IsTrackingViewState	Obtém um valor que indica se o objeto Parameter está salvando alterações no estado de exibiçã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 controle identificado pela propriedade ControlID à qual o objeto ControlParameter está associado.
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ções de estado que permite salvar e restaurar o estado de exibição de um objeto Parameter em várias solicitações da mesma página. (Herdado de Parameter)

Métodos

Clone()	Retorna uma duplicata da instância de ControlParameter atual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Evaluate(HttpContext, Control)	Atualiza e retorna o valor do objeto ControlParameter.
GetDatabaseType()	Obtém o valor DbType que é equivalente ao tipo CLR da instância Parameter atual. (Herdado de Parameter)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados. (Herdado de Parameter)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnParameterChanged()	Chama o método OnParametersChanged(EventArgs) da coleção ParameterCollection que contém o objeto Parameter. (Herdado de Parameter)
SaveViewState()	Salva as alterações ao estado de exibição do objeto Parameter desde a hora em que a página foi postada de volta no servidor. (Herdado de Parameter)
SetDirty()	Marca o objeto Parameter de modo que seu estado seja registrado no estado de exibição. (Herdado de Parameter)
ToString()	Converte o valor dessa instância na representação da cadeia de caracteres equivalente. (Herdado de Parameter)
TrackViewState()	Faz com que o objeto Parameter controle as alterações a seu estado de exibição de modo que elas possam ser armazenadas no objeto ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de Parameter)

Implantações explícitas de interface

ICloneable.Clone()	Retorna uma duplicata da instância de Parameter atual. (Herdado de Parameter)
IStateManager.IsTrackingViewState	Obtém um valor que indica se o objeto Parameter está salvando alterações no estado de exibição. (Herdado de Parameter)
IStateManager.LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados. (Herdado de Parameter)
IStateManager.SaveViewState()	Salva as alterações ao estado de exibição do objeto Parameter desde a hora em que a página foi postada de volta no servidor. (Herdado de Parameter)
IStateManager.TrackViewState()	Faz com que o objeto Parameter controle as alterações a seu estado de exibição de modo que elas possam ser armazenadas no objeto ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de Parameter)

Aplica-se a

Partilhar via