Ler em inglês

Compartilhar via

BaseValidator.ControlToValidate Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define o controle de entrada a ser validado.

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.ValidatedControlConverter))]
public string ControlToValidate { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.ValidatedControlConverter))]
[System.Web.UI.Themeable(false)]
public string ControlToValidate { get; set; }

Valor da propriedade

String

O controle de entrada a ser validado. O valor padrão é Empty, que indica que essa propriedade não está definida.

Atributos
TypeConverterAttribute ThemeableAttribute

Exemplos

O exemplo de código a seguir demonstra como usar a ControlToValidate propriedade para especificar o controle de entrada a ser validado.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

Comentários

Use a ControlToValidate propriedade para especificar o controle de entrada a ser validado. Essa propriedade deve ser definida como a ID de um controle de entrada para todos os controles de validação, exceto o CustomValidator controle , que pode ser deixado em branco. Se você não especificar um controle de entrada válido, uma exceção será gerada quando a página for renderizada. A ID deve se referir a um controle dentro do mesmo contêiner que o controle de validação. Ele deve estar na mesma página ou controle de usuário ou deve estar no mesmo modelo de um controle de modelo.

Os controles padrão que podem ser validados são:

Observação

Para que um controle de entrada seja validado, o System.Web.UI.ValidationPropertyAttribute atributo deve ser aplicado ao controle .

Todos os controles de validação, exceto o RequiredFieldValidator controle , passarão pela validação se o controle de entrada especificado pela ControlToValidate propriedade não contiver texto. Se você estiver usando um CustomValidator controle , as funções de validação do lado do cliente e do lado do servidor também não serão chamadas.

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Capas.

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também