CompareValidator 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.
Compara o valor inserido pelo usuário em um controle de entrada com o valor inserido em outro no controle de entrada, ou com um valor constante.
public ref class CompareValidator : System::Web::UI::WebControls::BaseCompareValidatorpublic class CompareValidator : System.Web.UI.WebControls.BaseCompareValidatortype CompareValidator = class
inherit BaseCompareValidatorPublic Class CompareValidator
Inherits BaseCompareValidator- Herança
Exemplos
O exemplo de código a seguir demonstra como usar um CompareValidator controle para comparar os valores em dois TextBox controles.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
<title>CompareValidator Example</title>
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
if (Page.IsValid)
{
lblOutput.Text = "Result: Valid!";
}
else
{
lblOutput.Text = "Result: Not valid!";
}
}
void Operator_Index_Changed(Object sender, EventArgs e)
{
Compare1.Operator = (ValidationCompareOperator) ListOperator.SelectedIndex;
Compare1.Validate();
}
void Type_Index_Changed(Object sender, EventArgs e)
{
Compare1.Type = (ValidationDataType) ListType.SelectedIndex;
Compare1.Validate();
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>CompareValidator Example</h3>
<br />
Enter a value in each textbox. Select a comparison operator<br />
and data type. Click "Validate" to compare values.
<table style="background-color:#eeeeee; padding:10">
<tr valign="top">
<td>
<h5>String 1:</h5>
<asp:TextBox id="TextBox1"
runat="server"/>
</td>
<td>
<h5>Comparison Operator:</h5>
<asp:ListBox id="ListOperator"
OnSelectedIndexChanged="Operator_Index_Changed"
runat="server">
<asp:ListItem Selected="True" Value="Equal">Equal</asp:ListItem>
<asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
<asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
<asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
<asp:ListItem Value="LessThan">LessThan</asp:ListItem>
<asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
<asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>
</asp:ListBox>
</td>
<td>
<h5>String 2:</h5>
<asp:TextBox id="TextBox2"
runat="server"/>
<br />
<asp:Button id="Button1"
Text="Validate"
OnClick="Button_Click"
runat="server"/>
</td>
</tr>
<tr>
<td colspan="3" align="center">
<h5>Data Type:</h5>
<asp:ListBox id="ListType"
OnSelectedIndexChanged="Type_Index_Changed"
runat="server">
<asp:ListItem Selected="true" Value="String" >String</asp:ListItem>
<asp:ListItem Value="Integer" >Integer</asp:ListItem>
<asp:ListItem Value="Double" >Double</asp:ListItem>
<asp:ListItem Value="Date" >Date</asp:ListItem>
<asp:ListItem Value="Currency" >Currency</asp:ListItem>
</asp:ListBox>
</td>
</tr>
</table>
<asp:CompareValidator id="Compare1"
ControlToValidate="TextBox1"
ControlToCompare="TextBox2"
EnableClientScript="False"
Type="String"
runat="server"/>
<br />
<asp:Label id="lblOutput"
Font-Names="verdana"
Font-Size="10pt"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
<title>CompareValidator Example</title>
<script runat="server">
Sub Button_Click(sender As Object, e As EventArgs)
If Page.IsValid Then
lblOutput.Text = "Result: Valid!"
Else
lblOutput.Text = "Result: Not valid!"
End If
End Sub
Sub Operator_Index_Changed(sender As Object, e As EventArgs)
Compare1.Operator = CType(ListOperator.SelectedIndex, ValidationCompareOperator)
Compare1.Validate()
End Sub
Sub Type_Index_Changed(sender As Object, e As EventArgs)
Compare1.Type = CType(ListType.SelectedIndex, ValidationDataType)
Compare1.Validate()
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>CompareValidator Example</h3>
<br />
Enter a value in each textbox. Select a comparison operator<br />
and data type. Click "Validate" to compare values.
<table style="background-color:#eeeeee; padding:10">
<tr valign="top">
<td>
<h5>String 1:</h5>
<asp:TextBox id="TextBox1"
runat="server"/>
</td>
<td>
<h5>Comparison Operator:</h5>
<asp:ListBox id="ListOperator"
OnSelectedIndexChanged="Operator_Index_Changed"
runat="server">
<asp:ListItem Selected="True" Value="Equal">Equal</asp:ListItem>
<asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
<asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
<asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
<asp:ListItem Value="LessThan">LessThan</asp:ListItem>
<asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
<asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>
</asp:ListBox>
</td>
<td>
<h5>String 2:</h5>
<asp:TextBox id="TextBox2"
runat="server"/>
<br />
<asp:Button id="Button1"
Text="Validate"
OnClick="Button_Click"
runat="server"/>
</td>
</tr>
<tr>
<td colspan="3" align="center">
<h5>Data Type:</h5>
<asp:ListBox id="ListType"
OnSelectedIndexChanged="Type_Index_Changed"
runat="server">
<asp:ListItem Selected="true" Value="String" >String</asp:ListItem>
<asp:ListItem Value="Integer" >Integer</asp:ListItem>
<asp:ListItem Value="Double" >Double</asp:ListItem>
<asp:ListItem Value="Date" >Date</asp:ListItem>
<asp:ListItem Value="Currency" >Currency</asp:ListItem>
</asp:ListBox>
</td>
</tr>
</table>
<asp:CompareValidator id="Compare1"
ControlToValidate="TextBox1"
ControlToCompare="TextBox2"
EnableClientScript="False"
Type="String"
runat="server"/>
<br />
<asp:Label id="lblOutput"
Font-Names="verdana"
Font-Size="10pt"
runat="server"/>
</form>
</body>
</html>
Comentários
Use o CompareValidator controle para comparar o valor inserido pelo usuário em um controle de entrada, como um TextBox controle, com o valor inserido em outro controle de entrada ou um valor constante. O CompareValidator controle passará pela validação se o valor do controle de entrada corresponder aos critérios especificados pelas Operatorpropriedades , ValueToComparee/ou ControlToCompare .
Você também pode usar o CompareValidator controle para indicar se o valor inserido em um controle de entrada pode ser convertido no tipo de dados especificado pela BaseCompareValidator.Type propriedade .
Especifique o controle de entrada a ser validado definindo a ControlToValidate propriedade . Se você quiser comparar um controle de entrada específico com outro controle de entrada, defina a ControlToCompare propriedade para especificar o controle com o qual comparar.
Observação
Se o valor inserido no controle de entrada especificado pela ControlToCompare propriedade não puder ser convertido no tipo de dados especificado pela BaseCompareValidator.Type propriedade , mas o valor inserido no controle de entrada especificado pela ControlToValidate propriedade puder ser convertido, o controle de entrada que está sendo validado será considerado válido. Portanto, você também deve colocar um CompareValidator controle ou RangeValidator no controle de entrada especificado pela ControlToCompare propriedade .
Em vez de comparar o valor de um controle de entrada com outro controle de entrada, você pode comparar o valor de um controle de entrada com um valor constante. Especifique o valor constante com o qual comparar definindo a ValueToCompare propriedade .
Observação
Se o valor especificado pela ValueToCompare propriedade não puder ser convertido no tipo de dados especificado pela BaseCompareValidator.Type propriedade , uma exceção será gerada. Certifique-se de marcar o tipo de dados de um valor antes de atribuí-lo programaticamente à ValueToCompare propriedade .
Observação
Não defina a ControlToCompare propriedade e ValueToCompare ao mesmo tempo. Você pode comparar o valor de um controle de entrada com outro controle de entrada ou com um valor constante. Se ambas as propriedades forem definidas, a ControlToCompare propriedade terá precedência.
Use a Operator propriedade para especificar o tipo de comparação a ser executada, como maior que, igual a e assim por diante. Se você definir a Operator propriedade como ValidationCompareOperator.DataTypeCheck, o CompareValidator controle ignorará as ControlToCompare propriedades e ValueToCompare e simplesmente indicará se o valor inserido no controle de entrada pode ser convertido no tipo de dados especificado pela BaseCompareValidator.Type propriedade .
A BaseCompareValidator.Type propriedade é usada para especificar o tipo de dados de ambos os valores de comparação. Ambos os valores são convertidos automaticamente nesse tipo de dados antes que a operação de comparação seja executada.
Importante
Quando a Type propriedade é definida como Date e o tipo de calendário atual não é gregoriano, o validador executa apenas a validação do lado do servidor. O script do cliente validador dá suporte apenas a calendários gregorianos.
A tabela a seguir lista os vários tipos de dados que podem ser comparados.
| Tipo de dados | Descrição |
|---|---|
String |
Um tipo de dados String. |
Integer |
Um tipo de dados inteiro com sinal de 32 bits. |
Double |
Um tipo de dados de número de ponto flutuante de precisão dupla. |
Date |
Um tipo de dados de data. |
Currency |
Um tipo de dados decimal. Ele não pode conter símbolos de moeda. |
Observação
Se o controle de entrada estiver vazio, nenhuma função de validação será chamada e a validação será bem-sucedida. Use um RequiredFieldValidator controle para exigir que o usuário insira dados no controle de entrada.
Observação
Ao usar o CompareValidator controle dentro de um UpdatePanel controle, verifique se o controle do validador e o controle ao qual ele está associado estão no mesmo painel. Para obter mais informações sobre como usar o UpdatePanel controle para atualizações de página parcial, consulte Visão geral da renderização de página parcial.
Para obter mais informações sobre controles de validação, consulte BaseValidator.
Acessibilidade
Para obter informações sobre como configurar esse controle para que ele gere marcação em conformidade com os padrões de acessibilidade, consulte Acessibilidade no Visual Studio e ASP.NET e controles de ASP.NET e acessibilidade.
Construtores
| CompareValidator() |
Inicializa uma nova instância da classe CompareValidator. |
Propriedades
| AccessKey |
Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web. (Herdado de WebControl) |
| Adapter |
Obtém o adaptador específico de navegador para o controle. (Herdado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control) |
| AssociatedControlID |
Não há suporte a esta propriedade. (Herdado de BaseValidator) |
| Attributes |
Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle. (Herdado de WebControl) |
| BackColor |
Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl) |
| BindingContainer |
Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control) |
| BorderColor |
Obtém ou define a cor da borda do controle Web. (Herdado de WebControl) |
| BorderStyle |
Obtém ou define o estilo de borda do controle de servidor Web. (Herdado de WebControl) |
| BorderWidth |
Obtém ou define a largura da borda do controle de servidor Web. (Herdado de WebControl) |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control) |
| Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control) |
| Controls |
Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de Control) |
| ControlStyle |
Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| ControlStyleCreated |
Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| ControlToCompare |
Obtém ou define o controle de entrada a ser comparado com o controle de entrada que está sendo validado. |
| ControlToValidate |
Obtém ou define o controle de entrada a ser validado. (Herdado de BaseValidator) |
| CssClass |
Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl) |
| CultureInvariantValues |
Obtém ou define um valor que indica se os valores são convertidos em um formato com neutralidade cultural antes que eles sejam comparados. (Herdado de BaseCompareValidator) |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control) |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
| Display |
Obtém ou define o comportamento de exibição da mensagem de erro em um controle de validação. (Herdado de BaseValidator) |
| EnableClientScript |
Obtém ou define um valor que indica se a validação do lado do cliente está habilitada. (Herdado de BaseValidator) |
| Enabled |
Obtém ou define um valor que indica se o controle de validação está habilitado. (Herdado de BaseValidator) |
| EnableTheming |
Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl) |
| EnableViewState |
Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
| ErrorMessage |
Obtém ou define o texto da mensagem de erro exibido em um controle ValidationSummary quando há falha na validação. (Herdado de BaseValidator) |
| Events |
Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
| Font |
Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl) |
| ForeColor |
Obtém ou define a cor da mensagem exibida quando a validação falha. (Herdado de BaseValidator) |
| HasAttributes |
Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl) |
| HasChildViewState |
Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control) |
| Height |
Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl) |
| ID |
Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle. (Herdado de Control) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control) |
| IsEnabled |
Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl) |
| IsTrackingViewState |
Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control) |
| IsUnobtrusive |
Obtém um valor que indica se o controle gera JavaScript discreto. (Herdado de BaseValidator) |
| IsValid |
Obtém ou define um valor que indica se o controle de entrada associado passa na validação. (Herdado de BaseValidator) |
| IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control) |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control) |
| Operator |
Obtém ou define a operação de comparação a ser executada. |
| Page |
Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control) |
| PropertiesValid |
Obtém um valor que indica se o controle especificado pela propriedade ControlToValidate é um controle válido. (Herdado de BaseValidator) |
| RenderingCompatibility |
Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RenderUplevel |
Obtém um valor que indica se o navegador do cliente dá suporte à renderização de "nível superior". (Herdado de BaseValidator) |
| SetFocusOnError |
Obtém ou define um valor que indica se o foco é definido para o controle especificado pela propriedade ControlToValidate quando a validação falhar. (Herdado de BaseValidator) |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou define a capa a ser aplicada ao controle. (Herdado de WebControl) |
| Style |
Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web. (Herdado de WebControl) |
| SupportsDisabledAttribute |
Obtém um valor que indica se o controle deve definir o atributo |
| TabIndex |
Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl) |
| TagKey |
Obtém a marca HTML usada para renderizar o controle Label. (Herdado de Label) |
| TagName |
Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control) |
| Text |
Obtém ou define o texto exibido no controle de validação quando a validação falha. (Herdado de BaseValidator) |
| ToolTip |
Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web. (Herdado de WebControl) |
| Type |
Obtém ou define o tipo de dados para os quais os valores que estão sendo comparados são convertidos, antes de fazer a comparação. (Herdado de BaseCompareValidator) |
| UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control) |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ValidationGroup |
Obtém ou define o nome do grupo de validação ao qual esse controle de validação pertence. (Herdado de BaseValidator) |
| ValueToCompare |
Obtém ou define um valor constante a ser comparado com o valor inserido pelo usuário no controle de entrada que está sendo validado. |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control) |
| Visible |
Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página. (Herdado de Control) |
| Width |
Obtém ou define a largura do controle de servidor Web. (Herdado de WebControl) |
Métodos
| AddAttributesToRender(HtmlTextWriter) |
Adiciona os atributos desse controle para o fluxo de saída para renderização no cliente. |
| AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controle de que um elemento foi analisado e adiciona o elemento ao controle Label. (Herdado de Label) |
| ApplyStyle(Style) |
Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de WebControl) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control) |
| CheckControlValidationProperty(String, String) |
Verifica se o controle especificado está na página e contém propriedades de validação. (Herdado de BaseValidator) |
| ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control) |
| ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control) |
| ControlPropertiesValid() |
Verifica as propriedades do controle em busca de valores válidos. |
| CopyBaseAttributes(WebControl) |
Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| CreateChildControls() |
Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control) |
| CreateControlCollection() |
Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control) |
| CreateControlStyle() |
Cria o objeto de estilo que é usado internamente pela classe WebControl para implementar todas as propriedades relacionadas a estilo. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Control) |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control) |
| DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control) |
| DetermineRenderUplevel() |
Determina se o controle de validação pode ser renderizado para um navegador mais recente ("nível superior"). (Herdado de BaseCompareValidator) |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control) |
| EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| EvaluateIsValid() |
Quando substituído em uma classe derivada, este método contém o código para determinar se o valor no controle de entrada é válido. |
| FindControl(String) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| Focus() |
Define o foco de entrada para um controle. (Herdado de Control) |
| GetControlRenderID(String) |
Obtém a ID do cliente do controle especificado. (Herdado de BaseValidator) |
| GetControlValidationValue(String) |
Obtém o valor associado ao controle de entrada especificado. (Herdado de BaseValidator) |
| GetDesignModeState() |
Obtém os dados de tempo de design para um controle. (Herdado de Control) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control) |
| HasControls() |
Determina se o controle de servidor contém algum controle filho. (Herdado de Control) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control) |
| IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). (Herdado de Control) |
| LoadViewState(Object) |
Carrega o estado salvo anteriormente para o controle. (Herdado de Label) |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| MergeStyle(Style) |
Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnInit(EventArgs) |
Aciona o evento Init. (Herdado de BaseValidator) |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender. (Herdado de BaseValidator) |
| OnUnload(EventArgs) |
Aciona o evento Unload. (Herdado de BaseValidator) |
| OpenFile(String) |
Obtém um Stream usado para ler um arquivo. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control) |
| RegisterValidatorCommonScript() |
Registra o código na página para a validação do lado do cliente. (Herdado de BaseValidator) |
| RegisterValidatorDeclaration() |
Registra uma declaração de matriz ECMAScript usando o nome da matriz |
| RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control) |
| Render(HtmlTextWriter) |
Exibe o controle no cliente. (Herdado de BaseValidator) |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderContents(HtmlTextWriter) |
Renderiza o conteúdo do Label no gravador especificado. (Herdado de Label) |
| RenderControl(HtmlTextWriter) |
Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a marca de fechamento HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control) |
| SaveViewState() |
Salva qualquer estado que foi modificado depois que o método TrackViewState() foi invocado. (Herdado de WebControl) |
| SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Faz com que o controle acompanhe as alterações a seu estado de exibição para que eles possam ser armazenados na propriedade ViewState do objeto. (Herdado de WebControl) |
| Validate() |
Executa validação no controle de entrada associado e atualiza a propriedade IsValid. (Herdado de BaseValidator) |
Eventos
| DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control) |
| Disposed |
Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control) |
| Load |
Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control) |
| PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control) |
| Unload |
Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
| IAttributeAccessor.GetAttribute(String) |
Obtém um atributo do controle da Web com o nome especificado. (Herdado de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controle da Web para o nome e o valor especificados. (Herdado de WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control) |
| IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado. |
| FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
| FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados. |
Aplica-se a
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de