Export (0) Print
Expand All

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 Language Filter 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

Show:
© 2014 Microsoft