RequiredAttribute Osztály

Definíció

Névtér:

System.ComponentModel.DataAnnotations

Szerelvény:

System.ComponentModel.Annotations.dll

Forrás:

RequiredAttribute.cs

Megadja, hogy szükség van-e adatmező-értékre.

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

Öröklődés

Object

Attribute

ValidationAttribute

RequiredAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa az attribútumot használja az RequiredAttribute adatbázisséma-szabály felülbírálására, amely lehetővé teszi, hogy egy adatmező üres legyen. A példa a következő lépéseket hajtja végre:

• Metaadatok részleges osztályát és a társított metaadatosztályt implementálja.

• A társított metaadatosztályban az RequiredAttribute attribútumot alkalmazza, amely a következő követelményeket határozza meg:

  • A Cím adatmező nem lehet üres. Ha az ellenőrzés sikertelen, a példában szereplő kód érvényesítési kivételt eredményez, és hibaüzenetet jelenít meg. A hibaüzenet akkor van megadva, amikor az attribútum az adatmezőre lesz alkalmazva.

  • A MiddleName adatmező nem lehet üres. Ha az ellenőrzés sikertelen, a példában szereplő kód érvényesítési kivételt eredményez, és hibaüzenetet jelenít meg.

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

Megjegyzések

Az RequiredAttribute attribútum azt határozza meg, hogy egy űrlap mezőinek ellenőrzésekor a mezőnek tartalmaznia kell egy értéket. Érvényesítési kivétel akkor merül fel, ha a tulajdonság nullüres sztringet ("") tartalmaz, vagy csak üres szóköz karaktereket tartalmaz.

Note

Ha az MVC adatmodell vagy entitás részleges osztálya tartalmaz egy olyan mezőt, amely az attribútummal RequiredAttribute van eljegyzve, de a lap nem tartalmazza a tulajdonságot, a hiba nem jelentkezik. Az érvényesítés csak a kiszolgálónak küldött mezők esetében történik.

Konstruktorok

Name	Description
RequiredAttribute()	Inicializálja a RequiredAttribute osztály új példányát.

Tulajdonságok

Name	Description
AllowEmptyStrings	Lekéri vagy beállít egy értéket, amely jelzi, hogy engedélyezett-e egy üres sztring.
ErrorMessage	Ha az ellenőrzés sikertelen, hibaüzenetet kap vagy állít be egy érvényesítési vezérlőhöz való társításhoz. (Öröklődés forrása ValidationAttribute)
ErrorMessageResourceName	Lekéri vagy beállítja a hibaüzenet erőforrásnevét a tulajdonság értékének kereséséhez, ha az ErrorMessageResourceType ellenőrzés sikertelen. (Öröklődés forrása ValidationAttribute)
ErrorMessageResourceType	Lekéri vagy beállítja az erőforrástípust a hibaüzenetek kereséséhez, ha az ellenőrzés sikertelen. (Öröklődés forrása ValidationAttribute)
ErrorMessageString	Lekéri a honosított érvényesítési hibaüzenetet. (Öröklődés forrása ValidationAttribute)
RequiresValidationContext	Olyan értéket kap, amely jelzi, hogy az attribútumhoz érvényesítési környezet szükséges-e. (Öröklődés forrása ValidationAttribute)
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
FormatErrorMessage(String)	Formázást alkalmaz egy hibaüzenetre annak az adatmezőnek az alapján, ahol a hiba történt. (Öröklődés forrása ValidationAttribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetValidationResult(Object, ValidationContext)	Ellenőrzi, hogy a megadott érték érvényes-e az aktuális érvényesítési attribútumra vonatkozóan. (Öröklődés forrása ValidationAttribute)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
IsValid(Object, ValidationContext)	Ellenőrzi a megadott értéket az aktuális érvényesítési attribútummal kapcsolatban. (Öröklődés forrása ValidationAttribute)
IsValid(Object)	Ellenőrzi, hogy a szükséges adatmező értéke nem üres-e.
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
Validate(Object, String)	Ellenőrzi a megadott objektumot. (Öröklődés forrása ValidationAttribute)
Validate(Object, ValidationContext)	Ellenőrzi a megadott objektumot. (Öröklődés forrása ValidationAttribute)