Freigeben über

BaseValidator.Display-Eigenschaft

  • Artikel

Ruft das Anzeigeverhalten der Fehlermeldung in einem Validierungssteuerelement ab oder legt dieses fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ThemeableAttribute(False)> _
Public Property Display As ValidatorDisplay
'Usage
Dim instance As BaseValidator
Dim value As ValidatorDisplay

value = instance.Display

instance.Display = value

[ThemeableAttribute(false)] 
public ValidatorDisplay Display { get; set; }

[ThemeableAttribute(false)] 
public:
property ValidatorDisplay Display {
    ValidatorDisplay get ();
    void set (ValidatorDisplay value);
}

/** @property */
public ValidatorDisplay get_Display ()

/** @property */
public void set_Display (ValidatorDisplay value)

public function get Display () : ValidatorDisplay

public function set Display (value : ValidatorDisplay)

Eigenschaftenwert

Einer der ValidatorDisplay-Werte. Der Standardwert ist Static.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

Der angegebene Wert ist kein ValidatorDisplay-Wert.

Hinweise

Mit der Display-Eigenschaft können Sie das Anzeigeverhalten der Fehlermeldung im Validierungssteuerelement angeben. In der folgenden Tabelle sind die verschiedenen Werte aufgelistet, die verwendet werden können.

Anzeigeverhalten

Beschreibung

None

Die Meldung für die Validierung wird grundsätzlich nicht inline angezeigt.

Static

Im Seitenlayout ist ein Bereich für die Meldung der Validierung reserviert.

Dynamic

Wenn die Validierung fehlschlägt, wird der Seite ein Bereich für die Meldung der Validierung dynamisch hinzugefügt.

Hinweis

Das Verhalten hängt davon ab, ob eine Validierung auf dem Client durchgeführt wird. Wenn die Validierung auf dem Client nicht aktiv ist (weil der Browser keine Unterstützung dafür bietet oder weil die Option durch die Page.ClientTarget-Seitendirektive oder die EnableClientScript-Eigenschaft deaktiviert wurde), verhalten sich ValidatorDisplay.Static und ValidatorDisplay.Dynamic gleich. Das heißt, für die Fehlermeldung ist nur dann Speicherplatz erforderlich, wenn sie angezeigt wird. Wenn die Meldung nicht angezeigt wird (ValidatorDisplay.Static), kann für sie nur dann Speicherplatz dynamisch reserviert werden, wenn die Validierung auf dem Client aktiviert ist.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.

Thema Position
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von Anwendungen mit Visual Web Developer

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie dieser Bereich für die Validierungsmeldung der Webseite mithilfe der Display-Eigenschaft dynamisch hinzugefügt wird, wenn die Validierung fehlschlägt.

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

<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>
  <body>
    <form 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>

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

<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>
  <body>
    <form 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="JScript" %>

<script runat="server">
 
  function Button_Click(sender, e : EventArgs) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html>
  <body>
    <form 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>

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

BaseValidator-Klasse
BaseValidator-Member
System.Web.UI.WebControls-Namespace
ValidatorDisplay