RequiredAttribute Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica che è necessario un valore di campo dati.
public ref class RequiredAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class RequiredAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class RequiredAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RequiredAttribute = class
inherit ValidationAttribute
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type RequiredAttribute = class
inherit ValidationAttribute
Public Class RequiredAttribute
Inherits ValidationAttribute
- Ereditarietà
- Attributi
Esempio
Nell'esempio seguente viene utilizzato l'attributo per eseguire l'override RequiredAttribute della regola dello schema del database che consente a un campo dati di essere vuoto. L'esempio esegue i passaggi seguenti:
Implementa una classe parziale di metadati e la classe di metadati associata.
Nella classe di metadati associata viene applicato l'attributo RequiredAttribute , che specifica i requisiti seguenti:
Il campo dati Titolo non può essere vuoto. Se la convalida ha esito negativo, il codice nell'esempio genera un'eccezione di convalida e visualizza un messaggio di errore. Il messaggio di errore viene specificato al momento dell'applicazione dell'attributo al campo dati.
Il campo dati MiddleName non può essere vuoto. Se la convalida ha esito negativo, il codice nell'esempio genera un'eccezione di convalida e visualizza un messaggio di errore.
using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;
using System.Globalization;
[MetadataType(typeof(CustomerMetaData))]
public partial class Customer
{
}
public class CustomerMetaData
{
// Require that the Title is not null.
// Use custom validation error.
[Required(ErrorMessage = "Title is required.")]
public object Title;
// Require that the MiddleName is not null.
// Use standard validation error.
[Required()]
public object MiddleName;
}
Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations
Imports System.Globalization
<MetadataType(GetType(CustomerMetaData))> _
Partial Public Class Customer
End Class
Public Class CustomerMetaData
' Require that the Title is not null.
' Use custom validation error.
<Required(ErrorMessage:="Title is required.")> _
Public Title As Object
' Require that the MiddleName is not null.
' Use standard validation error.
<Required()> _
Public MiddleName As Object
End Class
Commenti
L'attributo RequiredAttribute specifica che quando un campo di una maschera viene convalidato, il campo deve contenere un valore. Viene generata un'eccezione di convalida se la proprietà è null, contiene una stringa vuota ("") o contiene solo spazi vuoti.
Note
Se il modello di dati MVC o la classe parziale dell'entità contiene un campo annotato con l'attributo RequiredAttribute , ma la pagina non contiene la proprietà , non viene generato un errore. La convalida viene eseguita solo per i campi inviati al server.
Costruttori
| Nome | Descrizione |
|---|---|
| RequiredAttribute() |
Inizializza una nuova istanza della classe RequiredAttribute. |
Proprietà
| Nome | Descrizione |
|---|---|
| AllowEmptyStrings |
Ottiene o imposta un valore che indica se è consentita una stringa vuota. |
| ErrorMessage |
Ottiene o imposta un messaggio di errore da associare a un controllo di convalida se la convalida non riesce. (Ereditato da ValidationAttribute) |
| ErrorMessageResourceName |
Ottiene o imposta il nome della risorsa del messaggio di errore da utilizzare per cercare il valore della ErrorMessageResourceType proprietà in caso di esito negativo della convalida. (Ereditato da ValidationAttribute) |
| ErrorMessageResourceType |
Ottiene o imposta il tipo di risorsa da utilizzare per la ricerca di messaggi di errore in caso di esito negativo della convalida. (Ereditato da ValidationAttribute) |
| ErrorMessageString |
Ottiene il messaggio di errore di convalida localizzato. (Ereditato da ValidationAttribute) |
| RequiresValidationContext |
Ottiene un valore che indica se l'attributo richiede il contesto di convalida. (Ereditato da ValidationAttribute) |
| TypeId |
Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute. (Ereditato da Attribute) |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute) |
| FormatErrorMessage(String) |
Applica la formattazione a un messaggio di errore, in base al campo dati in cui si è verificato l'errore. (Ereditato da ValidationAttribute) |
| GetHashCode() |
Restituisce il codice hash per questa istanza. (Ereditato da Attribute) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetValidationResult(Object, ValidationContext) |
Verifica se il valore specificato è valido rispetto all'attributo di convalida corrente. (Ereditato da ValidationAttribute) |
| IsDefaultAttribute() |
Quando sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute) |
| IsValid(Object, ValidationContext) |
Convalida il valore specificato rispetto all'attributo di convalida corrente. (Ereditato da ValidationAttribute) |
| IsValid(Object) |
Verifica che il valore del campo dati richiesto non sia vuoto. |
| Match(Object) |
Quando sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| Validate(Object, String) |
Convalida l'oggetto specificato. (Ereditato da ValidationAttribute) |
| Validate(Object, ValidationContext) |
Convalida l'oggetto specificato. (Ereditato da ValidationAttribute) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Esegue il mapping di un set di nomi a un set corrispondente di identificatori dispatch. (Ereditato da Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Recupera le informazioni sul tipo per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per un'interfaccia. (Ereditato da Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Recupera il numero di interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fornisce l'accesso alle proprietà e ai metodi esposti da un oggetto . (Ereditato da Attribute) |