RequiredAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel.DataAnnotations

Zestaw:

System.ComponentModel.Annotations.dll

Źródło:

RequiredAttribute.cs

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. Przykład wykonuje następujące kroki:

• Implementuje klasę częściową metadanych i skojarzoną 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 po zweryfikowaniu pola w formularzu 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.

Uwaga

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

Konstruktory

RequiredAttribute()

Inicjuje nowe wystąpienie klasy RequiredAttribute.

Właściwości

AllowEmptyStrings	Pobiera lub ustawia wartość wskazującą, czy jest dozwolony pusty ciąg.
ErrorMessage	Pobiera lub ustawia komunikat o błędzie, który ma być skojarzony z kontrolką walidacji, jeśli walidacja nie powiedzie się. (Odziedziczone po ValidationAttribute)
ErrorMessageResourceName	Pobiera lub ustawia nazwę zasobu komunikatu o błędzie, która ma być używana 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 nie powiedzie się. (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 elementu Attribute. (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu 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 wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera bieżące wystąpienie. (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()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
IsValid(Object)	Sprawdza, czy wartość wymaganego pola danych nie jest pusta.
IsValid(Object, ValidationContext)	Weryfikuje określoną wartość w odniesieniu do bieżącego atrybutu walidacji. (Odziedziczone po ValidationAttribute)
Match(Object)	W przypadku zastąpienia 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)	Weryfikuje określony obiekt. (Odziedziczone po ValidationAttribute)
Validate(Object, ValidationContext)	Weryfikuje określony obiekt. (Odziedziczone po ValidationAttribute)