<validationsummary>

New to version 3.1
If you are validating fields on your form, this tag allows you to group all the validation messages into one area so that you user can see at-a-glance, the data that needs to be corrected.

 

ATTRIBUTES <validationsummary>:

ref

Name of this control. It must be unique within the form. (Required) [String value]  

Names must begin with a letter and may only include letters, numbers and the underscore character.

backcolor

Sets the background color of the control. Valid HTML color values can be used for this attribute (Optional)

bordercolor

Sets the border color of the control. Valid HTML color values can be used for this attribute (Optional)

borderstyle

How the border line should be drawn. (Optional)
Valid values are:

  • none (default)

  • dotted

  • dashed

  • solid

  • groove

  • double

  • ridge

  • inset

  • outset

Please note that not all border styles may be recognized by all browsers.

borderwidth

(Optional) Specifies the width, of the border. Values can be specified in various measurements:

Pixel (px) "1px"

Point (pt) "1pt"

Centimeter (cm) "1cm"

Millimeter (mm) "1mm"

Inch (in) "1in"

Em (em) "1em"

class

Name of the CSS Class used to style the text box (Optional) [String value]

displaymode

Sets the display mode of the control. Valid values are:

  • BulletList: Validation summary will be displayed as a bulleted list.

  • List: Summary is displayed in a list (each error on a new line)

  • SingleParagraph: Errors are displayed in a single paragraph.

forecolor

Sets the color of the text. Valid HTML color values can be used for this attribute (Optional). Default value is "red"

headertext

Sets the text that will be displayed as the title for the summary. (Optional)

height

Determines the height of the control. Values can specified in various measurements:

Pixel (px) "1px"

Point (pt) "1pt"

Centimeter (cm) "1cm"

Millimeter (mm) "1mm"

Inch (in) "1in"

Em (em) "1em"

showmessagebox

This can be true or false. The default value is false. If true, browsers capable of doing so will display a pop-up dialog box displaying the validation summary contents. (Optional)

showsummary

This can be true or false. The default value is true. If true, the validation summary will be displayed on the web page.

style

Same as the HTML style attribute.It allows you to apply CSS styling to the element (e.g. "color: red; border: solid 1px black;")  (Optional). [String value]
(New to version 3.2)

width

Specifies the width, of the control. Values can be specified in various measurements:

Pixel (px) "1px"

Point (pt) "1pt"

Centimeter (cm) "1cm"

Millimeter (mm) "1mm"

Inch (in) "1in"

Em (em) "1em"

 

EXAMPLE

The validation summary tag listed below will display any validation error messages as a bulleted list, with a yellow background, black text and a solid black border.

 

<input ref="txtQuantity" class="NormalTextBox" width="50px">

  <label>Quantity</label>

  <validate type="numeric" message="You must enter a number for Quantity" class="NormalRed"/>

</input>

 

<input ref="txtPassword" class="NormalTextBox" required="true" width="50px" password="true">

  <label>Password</label>

</input>

 

<validationsummary ref="summary1" headertext="Please correct the following errors:" backcolor="yellow" forecolor="black" bordercolor="black" borderstyle="solid" borderwidth="2px"></validationsummary>