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)
Syntax
'Declaration
Public Function ValidationSummary ( _
message As String, _
excludeFieldErrors As Boolean, _
htmlAttributes As IDictionary(Of String, Object) _
) As IHtmlString
'Usage
Dim instance As HtmlHelper
Dim message As String
Dim excludeFieldErrors As Boolean
Dim htmlAttributes As IDictionary(Of String, Object)
Dim returnValue As IHtmlString
returnValue = instance.ValidationSummary(message, _
excludeFieldErrors, htmlAttributes)
public IHtmlString ValidationSummary(
string message,
bool excludeFieldErrors,
IDictionary<string, Object> htmlAttributes
)
public:
IHtmlString^ ValidationSummary(
String^ message,
bool excludeFieldErrors,
IDictionary<String^, Object^>^ htmlAttributes
)
member ValidationSummary :
message:string *
excludeFieldErrors:bool *
htmlAttributes:IDictionary<string, Object> -> IHtmlString
public function ValidationSummary(
message : String,
excludeFieldErrors : boolean,
htmlAttributes : IDictionary<String, Object>
) : IHtmlString
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.
Remarks
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.