ValidationSummary Class
Displays a summary of all validation errors inline on a Web page, in a message box, or both.
For a list of all members of this type, see ValidationSummary Members.
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.ValidationSummary
[Visual Basic] Public Class ValidationSummary Inherits WebControl [C#] public class ValidationSummary : WebControl [C++] public __gc class ValidationSummary : public WebControl [JScript] public class ValidationSummary extends WebControl
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Remarks
The ValidationSummary class is used to summarize the error messages from all validators on a Web page in a single location. The summary can be displayed as a list, as a bulleted list, or as a single paragraph based on the DisplayMode property.
The summary can be displayed on the Web page and in a message box by setting the ShowSummary and ShowMessageBox properties, respectively.
For a list of initial property values for an instance of ValidationSummary, see the ValidationSummary constructor.
Example
[Visual Basic, C#] The following example demonstrates how to use a ValidationSummary control to summarize the error messages from all validation controls on a Web page and display them in a bulleted list.
[Visual Basic] <%@ 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> [C#] <%@ 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>
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Namespace: System.Web.UI.WebControls
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
Assembly: System.Web (in System.Web.dll)
See Also
ValidationSummary Members | System.Web.UI.WebControls Namespace | ValidationSummaryDisplayMode | BaseValidator | RequiredFieldValidator | DisplayMode | ShowMessageBox | ShowSummary | WebControl