HtmlHelper.ValidationSummary Method (String, Boolean, IDictionary<String, Object>)

Returns an HTML div element that has the specified custom attributes defined by an attribute dictionary, and that contains a summary message and an unordered list of validation error message from the model-state dictionary, optionally excluding field-level errors.

Namespace:  System.Web.WebPages.Html
Assembly:  System.Web.WebPages (in System.Web.WebPages.dll)

public IHtmlString ValidationSummary(
	string message,
	bool excludeFieldErrors,
	IDictionary<string, Object> htmlAttributes
)

Parameters

message
Type: System.String
The summary message that comes before the list of validation error messages.
excludeFieldErrors
Type: System.Boolean
true to exclude field-level validation error messages from the results; false to include both model-level and field-level validation error messages.
htmlAttributes
Type: System.Collections.Generic.IDictionary<String, Object>
The names and values of custom attributes for the element.

Return Value

Type: System.Web.IHtmlString
The HTML markup that represents the validation error messages.

This method is used in conjunction with the System.Web.Helpers.Validation class.

The returned markup consists of an HTML div element in the following form:

<div ...htmlAttributes...>
  <span>message</span>
  <ul>
    <li>summary message</li>
    <li>summary message</li>
    ...
  <ul>
</div>

Each summary message contains a validation error message that is associated with an error in the model state. If excludeFieldErrors is true, field-level errors are excluded from the list; otherwise, both model-level and field-level errors are included.

Show: