BaseValidator.Display Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger visningsbeteendet för felmeddelandet i en verifieringskontroll.

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

Egenskapsvärde

ValidatorDisplay

Ett av ValidatorDisplay värdena. Standardvärdet är Static.

Attribut
BindableAttribute ThemeableAttribute

Undantag

ArgumentOutOfRangeException

Det angivna värdet är inte ett av ValidatorDisplay värdena.

Exempel

I följande kodexempel visas hur du använder Display egenskapen för att ange att utrymmet för valideringsmeddelandet läggs till dynamiskt på webbsidan när verifieringen misslyckas.

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

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

Kommentarer

Använd egenskapen Display för att ange visningsbeteendet för felmeddelandet i verifieringskontrollen. I följande tabell visas de olika värden som kan användas.

Visa beteendemönster Description
None Verifieringsmeddelandet visas aldrig infogat.
Static Utrymmet för valideringsmeddelandet allokeras i sidlayouten.
Dynamic Utrymme för valideringsmeddelandet läggs dynamiskt till på sidan om verifieringen misslyckas.

Note

Visningsbeteendet beror på om verifiering på klientsidan utförs. Om validering på klientsidan inte är aktiv (eftersom webbläsaren inte stöder det eller eftersom det har inaktiverats med hjälp Page.ClientTarget av siddirektivet eller EnableClientScript egenskapen) ValidatorDisplay.Static och ValidatorDisplay.Dynamic fungerar på samma sätt: felmeddelandet tar bara upp utrymme om det visas. Möjligheten att dynamiskt allokera utrymme för meddelandet när det inte visas (ValidatorDisplay.Dynamic) fungerar bara med validering på klientsidan.

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Gäller för

Se även