ValidationSummary.DisplayMode Property

 

Gets or sets the display mode of the validation summary.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public ValidationSummaryDisplayMode DisplayMode { get; set; }

Property Value

Type: System.Web.UI.WebControls.ValidationSummaryDisplayMode

One of the ValidationSummaryDisplayMode values. The default is BulletList.

Exception Condition
ArgumentOutOfRangeException

The display mode is not one of the ValidationSummaryDisplayMode values.

Use this property to specify the display format of a ValidationSummary control. The summary can be displayed as a list, as a bulleted list, or as a single paragraph.

The following code example demonstrates how to set the DisplayMode property to display a bulleted list.

System_CAPS_security Security Note

This example has a text box that accepts user input, which is a potential security threat. 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      Name:<br/>
      <asp:textbox id="NameTextBox"
        runat="server"/>

      <asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
        controltovalidate="NameTextBox"
        errormessage="Name field."
        text="Please enter your name"
        runat="server"/>     

      <br/>  

      City:<br/>
      <asp:textbox id="CityTextBox"
        runat="server"/>

      <asp:requiredfieldvalidator id="CityTextBoxRequiredValidator"
        controltovalidate="CityTextBox"
        errormessage="City field."
        text="Please enter the city."
        runat="server"/> 

      <br/>

      <asp:Button id="SubmitButton"
        text="Submit"
        runat="server"/>

      <hr/>

      <asp:ValidationSummary 
        id="valSum" 
        displaymode="BulletList" 
        headertext="You must enter a value in the following fields:"
        runat="server"/>

    </form>
  </body>
</html>

.NET Framework
Available since 1.1
Return to top
Show: