ValidationSummary 类
在网页、消息框或在这两者中内联显示所有验证错误的摘要。
**命名空间:**System.Web.UI.WebControls
**程序集:**System.Web（在 system.web.dll 中）
语法
声明
Public Class ValidationSummary
Inherits WebControl
用法
Dim instance As ValidationSummary
public class ValidationSummary : WebControl
public ref class ValidationSummary : public WebControl
public class ValidationSummary extends WebControl
public class ValidationSummary extends WebControl
备注
ValidationSummary 类用于在一个位置总结来自网页上所有验证程序的错误信息。您可以通过设置 ValidationGroup 属性，将 ValidationSummary 控件分配给验证组，以汇总来自网页上的一组验证程序的错误信息。
根据 DisplayMode 属性的设置，摘要可以按列表、项目符号列表或单个段落的形式显示。
通过分别设置 ShowSummary 和 ShowMessageBox 属性，可在网页上和消息框中显示摘要。
有关 ValidationSummary 的实例的初始属性值列表，请参见 ValidationSummary 构造函数。
| 主题 | 位置 |
|---|---|
| 演练：验证 Web 窗体页中的用户输入 | 在 Visual Studio 中构建 ASP .NET Web 应用程序 |
| 演练：验证 Web 窗体页中的用户输入 | 使用 Visual Web Developer 生成应用程序 |
| 如何：对照数据库中的值验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：对照取值范围验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：对照特定值验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：对照数据类型验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：指定 ASP.NET 服务器控件上就地消息的布局 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：验证 ASP.NET 服务器控件的必需项 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：显示 ASP.NET 服务器控件的服务器端自定义验证消息 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：以编程方式测试 ASP.NET 服务器控件的有效性 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：控制 ASP.NET 服务器控件的验证错误信息显示 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：根据模式对 ASP.NET 服务器控件进行验证 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：以编程方式验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：设置 ASP.NET 服务器控件的验证错误信息的格式 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：使用自定义函数对 ASP.NET 服务器控件进行验证 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：禁用 ASP.NET 服务器控件验证 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：对照数据库中的值验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：对照取值范围验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：对照特定值验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：对照数据类型验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：指定 ASP.NET 服务器控件上就地消息的布局 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：验证 ASP.NET 服务器控件的必需项 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：显示 ASP.NET 服务器控件的服务器端自定义验证消息 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：以编程方式测试 ASP.NET 服务器控件的有效性 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：控制 ASP.NET 服务器控件的验证错误信息显示 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：根据模式对 ASP.NET 服务器控件进行验证 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：以编程方式验证 ASP.NET 服务器控件 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：设置 ASP.NET 服务器控件的验证错误信息的格式 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：使用自定义函数对 ASP.NET 服务器控件进行验证 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：禁用 ASP.NET 服务器控件验证 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 如何：对照数据库中的值验证 ASP.NET 服务器控件 | 生成 ASP .NET Web 应用程序 |
| 如何：对照取值范围验证 ASP.NET 服务器控件 | 生成 ASP .NET Web 应用程序 |
| 如何：对照特定值验证 ASP.NET 服务器控件 | 生成 ASP .NET Web 应用程序 |
| 如何：对照数据类型验证 ASP.NET 服务器控件 | 生成 ASP .NET Web 应用程序 |
| 如何：指定 ASP.NET 服务器控件上就地消息的布局 | 生成 ASP .NET Web 应用程序 |
| 如何：验证 ASP.NET 服务器控件的必需项 | 生成 ASP .NET Web 应用程序 |
| 如何：显示 ASP.NET 服务器控件的服务器端自定义验证消息 | 生成 ASP .NET Web 应用程序 |
| 如何：以编程方式测试 ASP.NET 服务器控件的有效性 | 生成 ASP .NET Web 应用程序 |
| 如何：控制 ASP.NET 服务器控件的验证错误信息显示 | 生成 ASP .NET Web 应用程序 |
| 如何：根据模式对 ASP.NET 服务器控件进行验证 | 生成 ASP .NET Web 应用程序 |
| 如何：以编程方式验证 ASP.NET 服务器控件 | 生成 ASP .NET Web 应用程序 |
| 如何：设置 ASP.NET 服务器控件的验证错误信息的格式 | 生成 ASP .NET Web 应用程序 |
| 如何：使用自定义函数对 ASP.NET 服务器控件进行验证 | 生成 ASP .NET Web 应用程序 |
| 如何：禁用 ASP.NET 服务器控件验证 | 生成 ASP .NET Web 应用程序 |
示例
下面的代码示例演示如何使用 ValidationSummary 控件汇总来自网页上所有验证控件的错误信息，然后在项目符号列表中显示这些信息。
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<h3>ValidationSummary Sample</h3>
<p>
<form runat="server">
<table cellpadding=10>
<tr>
<td>
<table bgcolor="#eeeeee" cellpadding=10>
<tr>
<td colspan=3>
<b>Credit Card Information</b>
</td>
</tr>
<tr>
<td align=right>
Card Type:
</td>
<td>
<asp:RadioButtonList id=RadioButtonList1
RepeatLayout="Flow"
runat=server>
<asp:ListItem>MasterCard</asp:ListItem>
<asp:ListItem>Visa</asp:ListItem>
</asp:RadioButtonList>
</td>
<td align=middle rowspan=1>
<asp:RequiredFieldValidator
id="RequiredFieldValidator1"
ControlToValidate="RadioButtonList1"
ErrorMessage="Card Type. "
Display="Static"
InitialValue="" Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td align=right>
Card Number:
</td>
<td>
<asp:TextBox id=TextBox1 runat=server />
</td>
<td>
<asp:RequiredFieldValidator
id="RequiredFieldValidator2"
ControlToValidate="TextBox1"
ErrorMessage="Card Number. "
Display="Static"
Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td></td>
<td>
<asp:Button
id=Button1
text="Validate"
runat=server />
</td>
<td></td>
</tr>
</table>
</td>
<td valign=top>
<table cellpadding=20>
<tr>
<td>
<asp:ValidationSummary
id="valSum"
DisplayMode="BulletList"
runat="server"
HeaderText="You must enter a value in the following fields:"
Font-Name="verdana"
Font-Size="12"/>
</td>
</tr>
</table>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<h3>ValidationSummary Sample</h3>
<p>
<form runat="server">
<table cellpadding=10>
<tr>
<td>
<table bgcolor="#eeeeee" cellpadding=10>
<tr>
<td colspan=3>
<b>Credit Card Information</b>
</td>
</tr>
<tr>
<td align=right>
Card Type:
</td>
<td>
<asp:RadioButtonList id=RadioButtonList1
RepeatLayout="Flow"
runat=server>
<asp:ListItem>MasterCard</asp:ListItem>
<asp:ListItem>Visa</asp:ListItem>
</asp:RadioButtonList>
</td>
<td align=middle rowspan=1>
<asp:RequiredFieldValidator
id="RequiredFieldValidator1"
ControlToValidate="RadioButtonList1"
ErrorMessage="Card Type. "
Display="Static"
InitialValue="" Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td align=right>
Card Number:
</td>
<td>
<asp:TextBox id=TextBox1 runat=server />
</td>
<td>
<asp:RequiredFieldValidator
id="RequiredFieldValidator2"
ControlToValidate="TextBox1"
ErrorMessage="Card Number. "
Display="Static"
Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td></td>
<td>
<asp:Button
id=Button1
text="Validate"
runat=server />
</td>
<td></td>
</tr>
</table>
</td>
<td valign=top>
<table cellpadding=20>
<tr>
<td>
<asp:ValidationSummary
id="valSum"
DisplayMode="BulletList"
runat="server"
HeaderText="You must enter a value in the following fields:"
Font-Name="verdana"
Font-Size="12"/>
</td>
</tr>
</table>
</td>
</tr>
</table>
</form>
</body>
</html>
继承层次结构
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.ValidationSummary
线程安全
此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。
平台
Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
请参见
参考
ValidationSummary 成员
System.Web.UI.WebControls 命名空间
ValidationSummaryDisplayMode
BaseValidator 类
RequiredFieldValidator 类
DisplayMode
ShowMessageBox
ShowSummary
WebControl