使用英语阅读

通过

BaseValidator.IsValid 属性

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

获取或设置一个值，该值指示关联的输入控件是否通过验证。

C# 
[System.ComponentModel.Browsable(false)]
public bool IsValid { get; set; }
C# 
[System.ComponentModel.Browsable(false)]
[System.Web.UI.Themeable(false)]
public bool IsValid { get; set; }

属性值

Boolean

如果关联的输入控件通过验证，则为 true；否则为 false。 默认值是 true。

实现

IsValid
属性
BrowsableAttribute ThemeableAttribute

示例

下面的代码示例演示如何使用 IsValid 属性来确定关联的输入控件是否通过验证。

重要

此示例具有一个接受用户输入的文本框，这是一个潜在的安全威胁。 默认情况下，ASP.NET 网页验证用户输入是否不包含脚本或 HTML 元素。 有关详细信息，请参阅脚本侵入概述。

ASP.NET (C#) 
<%@ 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>

注解

IsValid使用 属性可以确定关联的输入控件是否通过验证。

注意

由于此属性的默认值为 true，如果在执行验证之前查询此属性，它将返回 true 。 例如，如果尝试在发生页面时使用此属性， Control.Load 则可能会发生这种情况。

IsValid仅当调用 方法时，Validate才会计算 属性。 可以单独为页面上的每个验证控件调用 Validate 方法，也可以使用 方法一次性 Page.Validate 调用所有这些控件。 属性设置为 true 的CausesValidation按钮控件也将调用 Page.Validate 方法。

备注

在进行验证后，可以手动更改此属性的值。 这允许在必要时替代验证结果。

Page.IsValid仅当页面上每个验证控件的 属性也设置为 true 时IsValid，页面的 属性才会设置为 true。

无法通过主题或样式表主题设置此属性。 有关详细信息，请参阅 ThemeableAttribute 和 ASP.NET 主题和外观。

适用于

产品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另请参阅