Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Propriedade BaseValidator.Display

Obtém ou define o comportamento de exibição da mensagem de erro em um controle de validação.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

[ThemeableAttribute(false)]
public ValidatorDisplay Display { get; set; }
<asp:BaseValidator Display="ValidatorDisplay" />

Valor de propriedade

Tipo: System.Web.UI.WebControls.ValidatorDisplay
Um do ValidatorDisplay valores. O valor padrão é Static.

ExceçãoCondição
ArgumentOutOfRangeException

O valor especificado não é um do ValidatorDisplay valores.

Use o Display propriedade para especificar o comportamento de exibição da mensagem de erro no controle de validação. A tabela a seguir lista os diferentes valores que podem ser usados.

Comportamento de exibição

Descrição

None

A mensagem de validação nunca é exibida in-line.

Static

O espaço para a mensagem de validação é alocado no layout da página.

Dynamic

Espaço para a mensagem de validação é dinamicamente adicionado à página, se a validação falhar.

ObservaçãoObservação:

O comportamento de exibição depende se a validação do lado do cliente é executada.Se a validação do lado do cliente não estiver ativo (porque o navegador não oferece suporte ou porque ele foi desabilitado usando o Page.ClientTarget diretiva de página ou EnableClientScript propriedade) ValidatorDisplay.Static e ValidatorDisplay.Dynamic se comportam da mesma forma: a mensagem de erro ocupa espaço somente se ele estiver exibido.A capacidade de alocar dinamicamente espaço para a mensagem quando ele não está sendo exibido (ValidatorDisplay.Static) só funciona com a validação do lado do cliente.

Esta propriedade não pode ser definida por temas ou temas Planilha de estilos.Para obter mais informações, consulte ThemeableAttribute e Visão Geral de Temas e Aparências ASP.NET.

O exemplo de código a seguir demonstra como usar o Display propriedade para especificar que o espaço para a mensagem de validação é adicionada à página da Web dinamicamente quando a validação falhar.

Observação de segurançaObservação de segurança:

Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para obter mais informações, consulte Visão Geral de Scripts Maliciosos.

<%@ 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>



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0, 1.1, 1.0
Mostrar: