Fornisce supporto per la convalida dell'input da un form HTML.
System.Web.Mvc.Html.ValidationExtensions
Spazio dei nomi: System.Web.Mvc.Html
Assembly: System.Web.Mvc (in System.Web.Mvc.dll)
<ExtensionAttribute> _ Public NotInheritable Class ValidationExtensions
Non è necessario dichiarare un'istanza di una classe statica per accedere ai relativi membri.
public static class ValidationExtensions
[ExtensionAttribute] public ref class ValidationExtensions abstract sealed
public final class ValidationExtensions
Il tipo ValidationExtensions espone i membri seguenti.
| Nome | Descrizione | |
|---|---|---|
|
ResourceClassKey | Ottiene o imposta il nome del file di risorse (chiave della classe) che contiene valori stringa localizzati. |
| Nome | Descrizione | |
|---|---|---|
|
Validate | Recupera i metadati di convalida per il modello specificato e applica ogni regola al campo dati. |
|
|
ValidateFor<TModel, TProperty> | Recupera i metadati di convalida per il modello specificato e applica ogni regola al campo dati. |
|
|
ValidationMessage(HtmlHelper, String) | Visualizza un messaggio di convalida in caso di errore relativo al campo specificato nell'oggetto ModelStateDictionary. |
|
|
ValidationMessage(HtmlHelper, String, IDictionary<String, Object>) | Visualizza un messaggio di convalida in caso di errore relativo al campo specificato nell'oggetto ModelStateDictionary. |
|
|
ValidationMessage(HtmlHelper, String, Object) | Visualizza un messaggio di convalida in caso di errore relativo al campo specificato nell'oggetto ModelStateDictionary. |
|
|
ValidationMessage(HtmlHelper, String, String) | Visualizza un messaggio di convalida in caso di errore relativo al campo specificato nell'oggetto ModelStateDictionary. |
|
|
ValidationMessage(HtmlHelper, String, String, IDictionary<String, Object>) | Visualizza un messaggio di convalida in caso di errore relativo al campo specificato nell'oggetto ModelStateDictionary. |
|
|
ValidationMessage(HtmlHelper, String, String, Object) | Visualizza un messaggio di convalida in caso di errore relativo al campo specificato nell'oggetto ModelStateDictionary. |
|
|
ValidationMessageFor<TModel, TProperty>(HtmlHelper<TModel>, Expression<Func<TModel, TProperty>>) | Restituisce il markup HTML per un messaggio di errore di convalida per ogni campo dati rappresentato dall'espressione specificata. |
|
|
ValidationMessageFor<TModel, TProperty>(HtmlHelper<TModel>, Expression<Func<TModel, TProperty>>, String) | Restituisce il markup HTML per un messaggio di errore di convalida per ogni campo dati rappresentato dall'espressione specificata utilizzando il messaggio specificato. |
|
|
ValidationMessageFor<TModel, TProperty>(HtmlHelper<TModel>, Expression<Func<TModel, TProperty>>, String, IDictionary<String, Object>) | Restituisce il markup HTML per un messaggio di errore di convalida per ogni campo dati rappresentato dall'espressione specificata, utilizzando il messaggio e gli attributi HTML specificati. |
|
|
ValidationMessageFor<TModel, TProperty>(HtmlHelper<TModel>, Expression<Func<TModel, TProperty>>, String, Object) | Restituisce il markup HTML per un messaggio di errore di convalida per ogni campo dati rappresentato dall'espressione specificata, utilizzando il messaggio e gli attributi HTML specificati. |
|
|
ValidationSummary(HtmlHelper) | Restituisce un elenco non ordinato (l'elemento ul) di messaggi di convalida inclusi nell'oggetto ModelStateDictionary. |
|
|
ValidationSummary(HtmlHelper, Boolean) | Restituisce un elenco non ordinato (elemento ul ) di messaggi di convalida inclusi nell'oggetto ModelStateDictionary e che visualizzano facoltativamente solo errori a livello di modello. |
|
|
ValidationSummary(HtmlHelper, String) | Restituisce un elenco non ordinato (l'elemento ul) di messaggi di convalida inclusi nell'oggetto ModelStateDictionary. |
|
|
ValidationSummary(HtmlHelper, Boolean, String) | Restituisce un elenco non ordinato (elemento ul ) di messaggi di convalida inclusi nell'oggetto ModelStateDictionary e che visualizzano facoltativamente solo errori a livello di modello. |
|
|
ValidationSummary(HtmlHelper, String, IDictionary<String, Object>) | Restituisce un elenco non ordinato (l'elemento ul) di messaggi di convalida inclusi nell'oggetto ModelStateDictionary. |
|
|
ValidationSummary(HtmlHelper, String, Object) | Restituisce un elenco non ordinato (l'elemento ul) di messaggi di convalida inclusi nell'oggetto ModelStateDictionary. |
|
|
ValidationSummary(HtmlHelper, Boolean, String, IDictionary<String, Object>) | Restituisce un elenco non ordinato (elemento ul ) di messaggi di convalida inclusi nell'oggetto ModelStateDictionary e che visualizzano facoltativamente solo errori a livello di modello. |
|
|
ValidationSummary(HtmlHelper, Boolean, String, Object) | Restituisce un elenco non ordinato (elemento ul ) di messaggi di convalida inclusi nell'oggetto ModelStateDictionary e che visualizzano facoltativamente solo errori a livello di modello. |
The ValidationExtensions class contains methods that extend the HtmlHelper class. The ValidationMessage method renders a validation message if the specified field contains invalid input. The ValidationSummary method displays a list of all validation messages on the page. These methods require the view to be strongly typed.
If the DefaultModelBinder instance cannot bind a form-field value to the model, the binder adds an error to the ModelState object. When the view is rendered, the validation messages and validation summary are displayed based on the Errors property of the ModelState object.
You can control the appearance of the validation messages and validation summary by modifying the following cascading style sheet (CSS) classes in the Site.css file:
-
input-validation-error. This rule is applied to the input element that is rendered by the TextBox helper method.
-
field-validation-error. This rule is applied to the span element that is rendered by the ValidationMessage method.
-
validation-summary-error. This rule is applies to the ul element that is rendered by the ValidationMessage method.
The following example shows one way to use the ValidationSummary and ValidationMessage methods in MVC applications. This example defines a model class named Person. The Person class establishes the basic member requirements. For example, Name must be a string and Age must be an integer.
The Create view enables the user to create a new Person object. A call to the ValidationSummary method is placed in the view ahead of the entry form. If an invalid value is submitted, the summary displays an error message. A call is made to the ValidationMessage method following each form field. If the associated form field contains an invalid value, the field is marked with an asterisk (*).
When the form is submitted, the Create action method handles the request. In this example, the Create method checks validation errors, such as whether the phone number and email address match the regular expressions that define a valid entry. If an error is found, an error message is added to the ModelState object and the Create view is re-displayed showing the errors.