RequiredAttribute Klasse

Definition

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Quelle:

RequiredAttribute.cs

Gibt an, dass ein Datenfeldwert erforderlich ist.

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

Vererbung

Object

Attribute

ValidationAttribute

RequiredAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird das RequiredAttribute -Attribut verwendet, um die Datenbankschemaregel außer Kraft zu setzen, mit der ein Datenfeld leer sein kann. Im Beispiel werden die folgenden Schritte ausgeführt:

• Implementiert eine partielle Metadatenklasse und die zugeordnete Metadatenklasse.

• In der zugeordneten Metadatenklasse wird das RequiredAttribute -Attribut angewendet, das die folgenden Anforderungen angibt:

  • Das Datenfeld Titel darf nicht leer sein. Wenn die Überprüfung fehlschlägt, löst der Code im Beispiel eine Validierungs-Ausnahme aus und zeigt eine Fehlermeldung an. Die Fehlermeldung wird zu dem Zeitpunkt angegeben, zu dem das Attribut auf das Datenfeld angewendet wird.

  • Das Datenfeld MiddleName darf nicht leer sein. Wenn die Überprüfung fehlschlägt, löst der Code im Beispiel eine Validierungs-Ausnahme aus und zeigt eine Fehlermeldung an.

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

Hinweise

Das RequiredAttribute -Attribut gibt an, dass das Feld einen Wert enthalten muss, wenn ein Feld in einem Formular überprüft wird. Eine Validierungsausnahme wird ausgelöst, wenn die -Eigenschaft ist null, eine leere Zeichenfolge ("") enthält oder nur Leerzeichen enthält.

Hinweis

Wenn das MVC-Datenmodell oder die entitätsteilte Klasse ein Feld enthält, das mit dem RequiredAttribute -Attribut kommentiert ist, die Seite jedoch keine -Eigenschaft enthält, wird kein Fehler ausgelöst. Die Überprüfung erfolgt nur für Felder, die an den Server übermittelt werden.

Konstruktoren

RequiredAttribute()

Initialisiert eine neue Instanz der RequiredAttribute-Klasse.

Eigenschaften

AllowEmptyStrings	Ruft einen Wert ab, der angibt, ob eine leere Zeichenfolge zulässig ist, oder legt diesen Wert fest.
ErrorMessage	Ruft eine Fehlermeldung ab, die beim Fehlschlagen der Validierung einem Validierungssteuerelement zugeordnet wird, oder legt diese fest. (Geerbt von ValidationAttribute)
ErrorMessageResourceName	Ruft den Fehlermeldungsressourcennamen ab, mithilfe dessen der ErrorMessageResourceType-Eigenschaftswert nachgeschlagen werden soll, wenn die Validierung fehlschlägt, oder legt diesen fest. (Geerbt von ValidationAttribute)
ErrorMessageResourceType	Ruft den Ressourcentyp ab, der für die Fehlermeldungssuche verwendet werden soll, wenn die Validierung fehlschlägt, oder legt ihn fest. (Geerbt von ValidationAttribute)
ErrorMessageString	Ruft die lokalisierte Validierungsfehlermeldung ab. (Geerbt von ValidationAttribute)
RequiresValidationContext	Ruft einen Wert ab, der angibt, ob das Attribut Validierungskontext erfordert. (Geerbt von ValidationAttribute)
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
FormatErrorMessage(String)	Wendet eine Formatierung auf eine Fehlermeldung auf Grundlage des Datenfelds an, in dem der Fehler aufgetreten ist. (Geerbt von ValidationAttribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValidationResult(Object, ValidationContext)	Überprüft, ob der angegebene Wert in Bezug auf das aktuelle Validierungsattribut gültig ist. (Geerbt von ValidationAttribute)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
IsValid(Object)	Überprüft, dass der Wert des erforderlichen Datenfelds nicht leer ist.
IsValid(Object, ValidationContext)	Überprüft den angegebenen Wert in Bezug auf das aktuelle Validierungsattribut. (Geerbt von ValidationAttribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Validate(Object, String)	Validiert das angegebene Objekt. (Geerbt von ValidationAttribute)
Validate(Object, ValidationContext)	Validiert das angegebene Objekt. (Geerbt von ValidationAttribute)