BaseValidator.IsValid Свойство

Определение

Получает или задает значение, показывающее, прошел ли проверку соответствующий элемент управления для ввода.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)]
[System.Web.UI.Themeable(false)]
public bool IsValid { get; set; }
member this.IsValid : bool with get, set
Public Property IsValid As Boolean

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

Значение true, если соответствующий элемент управления для ввода прошел проверку; в противном случае — значение false.true if the associated input control passes validation; otherwise, false. Значение по умолчанию — true.The default value is true.

Реализации

Атрибуты

Примеры

В следующем примере кода показано, как использовать IsValid свойство, чтобы определить, прошел ли проверку связанный элемент управления вводом.The following code example demonstrates how to use the IsValid property to determine whether the associated input control passes validation.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.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 (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>

Комментарии

IsValid Используйте свойство, чтобы определить, прошел ли проверку связанный элемент управления вводом.Use the IsValid property to determine whether the associated input control passes validation.

Внимание!

Так как значение этого свойства по умолчанию trueравно, оно будет true возвращать, если вы запрашиваете это свойство перед выполнением проверки.Because the default value of this property is true, it will return true if you query this property before validation is performed. Например, это может произойти при попытке использовать это свойство в Control.Load событии страницы.For example, this might occur if you attempt to use this property in the Control.Load event of a page.

Свойство вычисляется только при вызове Validateметода. IsValidThe IsValid property is evaluated only when the Validate method is called. Validate Метод можно вызывать для каждого элемента управления проверки на странице по отдельности или вызывать сразу все из них с 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. Элементы управления CausesValidation "Кнопка", для true которых задано свойство Page.Validate , также будут вызывать метод.Button controls with their CausesValidation property set to true will also call the Page.Validate method.

Примечание

Значение этого свойства можно изменить вручную после выполнения проверки.It is possible to change the value of this property manually after validation has taken place. Это позволяет переопределить результат проверки, если это необходимо.This allows you to override the validation result, if necessary.

Свойству страницы присваивается true значение, только если IsValid свойству для каждого trueэлемента управления проверки на странице также присвоено значение. Page.IsValidThe 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.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.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.

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

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