BaseValidator.IsValid Proprietà

Definizione

Ottiene o imposta un valore che indica se il controllo di input associato supera la convalida.Gets or sets a value that indicates whether the associated input control passes validation.

public:
 property bool IsValid { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool IsValid { get; set; }
[System.ComponentModel.Browsable(false)]
[System.Web.UI.Themeable(false)]
public bool IsValid { get; set; }
member this.IsValid : bool with get, set
Public Property IsValid As Boolean

Valore della proprietà

true se il controllo di input associato supera la convalida; in caso contrario, false.true if the associated input control passes validation; otherwise, false. Il valore predefinito è true.The default value is true.

Implementazioni

Attributi

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà IsValid per determinare se il controllo di input associato supera la convalida.The following code example demonstrates how to use the IsValid property to determine whether the associated input control passes validation.

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 (NumberCompareValidator.IsValid && TextBoxRequiredValidator.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 NumberCompareValidator.IsValid And TextBoxRequiredValidator.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à IsValid per determinare se il controllo di input associato supera la convalida.Use the IsValid property to determine whether the associated input control passes validation.

Attenzione

Poiché il valore predefinito di questa proprietà è true, viene restituito true se si esegue una query su questa proprietà prima che venga eseguita la convalida.Because the default value of this property is true, it will return true if you query this property before validation is performed. Questo può verificarsi, ad esempio, se si tenta di utilizzare questa proprietà nell'evento Control.Load di una pagina.For example, this might occur if you attempt to use this property in the Control.Load event of a page.

La proprietà IsValid viene valutata solo quando viene chiamato il metodo Validate.The IsValid property is evaluated only when the Validate method is called. È possibile chiamare il metodo Validate per ogni controllo di convalida della pagina singolarmente oppure chiamarli tutti contemporaneamente usando il metodo Page.Validate.You can call the Validate method for each validation control on the page individually, or call all of them at once by using the Page.Validate method. I controlli Button con la proprietà CausesValidation impostata su true chiameranno anche il metodo Page.Validate.Button controls with their CausesValidation property set to true will also call the Page.Validate method.

Nota

È possibile modificare manualmente il valore di questa proprietà dopo che è stata eseguita la convalida.It is possible to change the value of this property manually after validation has taken place. In questo modo, se necessario, è possibile eseguire l'override del risultato della convalida.This allows you to override the validation result, if necessary.

La proprietà Page.IsValid della pagina è impostata su true solo se la proprietà IsValid per ogni controllo di convalida della pagina è impostata anche su true.The Page.IsValid property for the page is set to true only if the IsValid property for each validation control on the page is also set to true.

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