RequiredAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel.DataAnnotations

Zestaw:

System.ComponentModel.DataAnnotations.dll

Określa, że wymagana jest wartość pola danych.

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.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RequiredAttribute = class
    inherit ValidationAttribute

Public Class RequiredAttribute
Inherits ValidationAttribute

Dziedziczenie

Object

Attribute

ValidationAttribute

RequiredAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie użyto atrybutu RequiredAttribute , aby zastąpić regułę schematu bazy danych, która umożliwia puste pole danych. W przykładzie są wykonywane następujące kroki:

• Implementuje klasę częściową metadanych i skojarzą klasę metadanych.

• W skojarzonej klasie metadanych stosuje RequiredAttribute atrybut, który określa następujące wymagania:

  • Pole Dane tytułu nie może być puste. Jeśli walidacja nie powiedzie się, kod w przykładzie zgłasza wyjątek weryfikacji i wyświetla komunikat o błędzie. Komunikat o błędzie jest określony w momencie zastosowania atrybutu do pola danych.

  • Pole danych MiddleName nie może być puste. Jeśli walidacja nie powiedzie się, kod w przykładzie zgłasza wyjątek weryfikacji i wyświetla komunikat o błędzie.

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

Uwagi

Atrybut RequiredAttribute określa, że gdy pole w formularzu zostanie zweryfikowane, pole musi zawierać wartość. Wyjątek weryfikacji jest zgłaszany, jeśli właściwość to null, zawiera pusty ciąg (""), lub zawiera tylko znaki odstępu.

Note

Jeśli model danych MVC lub klasa częściowa jednostki zawiera pole, które jest oznaczone atrybutem RequiredAttribute , ale strona nie zawiera właściwości, błąd nie jest zgłaszany. Walidacja odbywa się tylko w przypadku pól przesyłanych do serwera.

Konstruktory

Nazwa	Opis
RequiredAttribute()	Inicjuje nowe wystąpienie klasy RequiredAttribute.

Właściwości

Nazwa	Opis
AllowEmptyStrings	Pobiera lub ustawia wartość wskazującą, czy pusty ciąg jest dozwolony.
ErrorMessage	Pobiera lub ustawia komunikat o błędzie do skojarzenia z kontrolką weryfikacji, jeśli walidacja zakończy się niepowodzeniem. (Odziedziczone po ValidationAttribute)
ErrorMessageResourceName	Pobiera lub ustawia nazwę zasobu komunikatu o błędzie do użycia w celu wyszukania ErrorMessageResourceType wartości właściwości w przypadku niepowodzenia walidacji. (Odziedziczone po ValidationAttribute)
ErrorMessageResourceType	Pobiera lub ustawia typ zasobu, który ma być używany do wyszukiwania komunikatów o błędzie, jeśli walidacja zakończy się niepowodzeniem. (Odziedziczone po ValidationAttribute)
ErrorMessageString	Pobiera zlokalizowany komunikat o błędzie weryfikacji. (Odziedziczone po ValidationAttribute)
RequiresValidationContext	Pobiera wartość wskazującą, czy atrybut wymaga kontekstu weryfikacji. (Odziedziczone po ValidationAttribute)
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute. (Odziedziczone po Attribute)

Metody

Nazwa	Opis
Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
FormatErrorMessage(String)	Stosuje formatowanie do komunikatu o błędzie na podstawie pola danych, w którym wystąpił błąd. (Odziedziczone po ValidationAttribute)
GetHashCode()	Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValidationResult(Object, ValidationContext)	Sprawdza, czy określona wartość jest prawidłowa w odniesieniu do bieżącego atrybutu weryfikacji. (Odziedziczone po ValidationAttribute)
IsDefaultAttribute()	Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
IsValid(Object, ValidationContext)	Weryfikuje określoną wartość w odniesieniu do bieżącego atrybutu weryfikacji. (Odziedziczone po ValidationAttribute)
IsValid(Object)	Sprawdza, czy wartość wymaganego pola danych nie jest pusta.
Match(Object)	Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Validate(Object, String)	Sprawdza poprawność określonego obiektu. (Odziedziczone po ValidationAttribute)
Validate(Object, ValidationContext)	Sprawdza poprawność określonego obiektu. (Odziedziczone po ValidationAttribute)

Jawne implementacje interfejsu

Nazwa	Opis
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Zapewnia dostęp do właściwości i metod uwidocznionych przez obiekt. (Odziedziczone po Attribute)