ControlParameter Classe
Definição
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::Parameterpublic class ControlParameter : System.Web.UI.WebControls.Parametertype ControlParameter = class
inherit ParameterPublic Class ControlParameter
Inherits Parameter- Herança
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 do 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
| 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, 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, 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, String) |
Inicializa uma nova instância nomeada da ControlParameter classe, usando o nome de controle especificado para identificar a qual controle 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 de controle especificados para identificar a qual controle associar. |
Propriedades
| Nome | Description |
|---|---|
| ControlID |
Especifica o nome do controle ao qual o ControlParameter objeto se associa. |
| ConvertEmptyStringToNull |
Obtém ou define um valor que indica se o valor ao qual o Parameter objeto está associado deve ser convertido |
| 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 que o parâmetro esteja associado seja 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 controle ou se o controle pode ser usado para alterar o valor. (Herdado de Parameter) |
| IsTrackingViewState |
Obtém um valor que indica se o Parameter objeto está salvando alterações em seu 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 ControlID propriedade à qual o ControlParameter objeto se associa. |
| 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 Parameter objeto em várias solicitações para a mesma página. (Herdado de Parameter) |
Métodos
| Nome | Description |
|---|---|
| Clone() |
Retorna uma duplicata da instância atual ControlParameter . |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Evaluate(HttpContext, Control) |
Atualiza e retorna 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 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 da fonte de dados. (Herdado de Parameter) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnParameterChanged() |
Chama o OnParametersChanged(EventArgs) método da ParameterCollection coleção que contém o Parameter objeto. (Herdado de Parameter) |
| SaveViewState() |
Salva as alterações no Parameter estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor. (Herdado de Parameter) |
| SetDirty() |
Marca o Parameter objeto para que seu estado seja registrado no estado de exibição. (Herdado de Parameter) |
| ToString() |
Converte o valor dessa instância em sua representação de cadeia de caracteres equivalente. (Herdado de Parameter) |
| TrackViewState() |
Faz com que o Parameter objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de Parameter) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| ICloneable.Clone() |
Retorna uma duplicata da instância atual Parameter . (Herdado de Parameter) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se o Parameter objeto está salvando alterações em seu estado de exibição. (Herdado de Parameter) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados. (Herdado de Parameter) |
| IStateManager.SaveViewState() |
Salva as alterações no Parameter estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor. (Herdado de Parameter) |
| IStateManager.TrackViewState() |
Faz com que o Parameter objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de Parameter) |
