BaseValidator.Display Свойство

Определение

Получает или задает поведение при отображении сообщения об ошибке в элементе управления проверки.Gets or sets the display behavior of the error message in a validation control.

public:
 property System::Web::UI::WebControls::ValidatorDisplay Display { System::Web::UI::WebControls::ValidatorDisplay get(); void set(System::Web::UI::WebControls::ValidatorDisplay value); };
[System.Web.UI.Themeable(true)]
[System.ComponentModel.Bindable(true)]
public System.Web.UI.WebControls.ValidatorDisplay Display { get; set; }
member this.Display : System.Web.UI.WebControls.ValidatorDisplay with get, set
Public Property Display As ValidatorDisplay

Значение свойства

Одно из значений перечисления ValidatorDisplay.One of the ValidatorDisplay values. Значение по умолчанию — Static.The default value is Static.

Атрибуты

Исключения

Указанное значение не является одним из значений ValidatorDisplay.The specified value is not one of the ValidatorDisplay values.

Примеры

В следующем примере кода показано, как использовать Display свойство, чтобы указать, что пространство для сообщения проверки добавляется на веб-страницу динамически при сбое проверки.The following code example demonstrates how to use the Display property to specify that space for the validation message is added to the Web page dynamically when validation fails.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.For more information, see Script Exploits Overview.

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

<%@ Page Language="VB" AutoEventWireup="False" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If Page.IsValid Then
    
      MessageLabel.Text = "Page submitted successfully."
    
    Else
    
      MessageLabel.Text = "There is an error on the page."
    
    End If
    
  End Sub
 
</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"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

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

Комментарии

Display Используйте свойство, чтобы указать поведение при отображении сообщения об ошибке в элементе управления проверки.Use the Display property to specify the display behavior of the error message in the validation control. В следующей таблице перечислены различные значения, которые можно использовать.The following table lists the different values that can be used.

Поведение при отображенииDisplay behavior ОписаниеDescription
None Сообщение проверки никогда не отображается в строке.The validation message is never displayed inline.
Static Место для сообщения проверки выделяется в макете страницы.Space for the validation message is allocated in the page layout.
Dynamic Пространство для сообщения проверки динамически добавляется на страницу, если проверка завершается неудачно.Space for the validation message is dynamically added to the page if validation fails.

Примечание

Поведение при отображении зависит от того, выполняется ли проверка на стороне клиента.The display behavior depends on whether client-side validation is performed. Если проверка на стороне клиента неактивна (так как браузер не поддерживает ее или она была Page.ClientTarget отключена с помощью директивы страницы или EnableClientScript свойства) ValidatorDisplay.Static и ValidatorDisplay.Dynamic поведение аналогично: сообщение об ошибке Освободите место только в том случае, если оно отображается.If client-side validation is not active (because the browser does not support it or because it has been disabled by using the Page.ClientTarget page directive or EnableClientScript property), ValidatorDisplay.Static and ValidatorDisplay.Dynamic behave the same way: the error message takes up space only if it is displayed. Возможность динамического выделения пространства для сообщения, когда оно не отображается (ValidatorDisplay.Dynamic), работает только с проверкой на стороне клиента.The ability to dynamically allocate space for the message when it is not being displayed (ValidatorDisplay.Dynamic) only works with client-side validation.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.This property cannot be set by themes or style sheet themes. Дополнительные сведения см ThemeableAttribute . в статьях и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Применяется к

Дополнительно