BaseValidator.Display Proprietà

Definizione

Ottiene o imposta il comportamento di visualizzazione del messaggio di errore in un controllo di convalida.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.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; }
member this.Display : System.Web.UI.WebControls.ValidatorDisplay with get, set
Public Property Display As ValidatorDisplay

Valore della proprietà

Uno dei valori ValidatorDisplay.One of the ValidatorDisplay values. Il valore predefinito è Static.The default value is Static.

Attributi

Eccezioni

Il valore specificato non è uno dei valori di ValidatorDisplay.The specified value is not one of the ValidatorDisplay values.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà Display per specificare in modo dinamico che lo spazio per il messaggio di convalida viene aggiunto alla pagina Web quando la convalida ha esito negativo.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.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.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>

Commenti

Utilizzare la proprietà Display per specificare il comportamento di visualizzazione del messaggio di errore nel controllo di convalida.Use the Display property to specify the display behavior of the error message in the validation control. La tabella seguente elenca i diversi valori che è possibile usare.The following table lists the different values that can be used.

Comportamento di visualizzazioneDisplay behavior DescrizioneDescription
None Il messaggio di convalida non viene mai visualizzato inline.The validation message is never displayed inline.
Static Lo spazio per il messaggio di convalida viene allocato nel layout di pagina.Space for the validation message is allocated in the page layout.
Dynamic Lo spazio per il messaggio di convalida viene aggiunto dinamicamente alla pagina se la convalida ha esito negativo.Space for the validation message is dynamically added to the page if validation fails.

Nota

Il comportamento di visualizzazione varia a seconda che venga eseguita la convalida lato client.The display behavior depends on whether client-side validation is performed. Se la convalida sul lato client non è attiva (poiché il browser non la supporta o perché è stata disabilitata tramite la direttiva della pagina Page.ClientTarget o la proprietà EnableClientScript), ValidatorDisplay.Static e ValidatorDisplay.Dynamic comportarsi nello stesso modo: il messaggio di errore occupa spazio solo se viene visualizzato.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. La possibilità di allocare in modo dinamico lo spazio per il messaggio quando non viene visualizzato (ValidatorDisplay.Dynamic) funziona solo con la convalida lato client.The ability to dynamically allocate space for the message when it is not being displayed (ValidatorDisplay.Dynamic) only works with client-side validation.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile.This property cannot be set by themes or style sheet themes. Per ulteriori informazioni, vedere i temi e le interfaccedi ThemeableAttribute e ASP.NET.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Si applica a

Vedi anche