RequiredAttribute Klasse

Definition

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.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
Vererbung
Attribute

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 wendet sie das RequiredAttribute Attribut an, das die folgenden Anforderungen angibt:

    • Das Feld "Titeldaten" darf nicht leer sein. Wenn die Überprüfung fehlschlägt, löst der Code im Beispiel eine Gültigkeitsprüfungs exception aus und zeigt eine Fehlermeldung an. Die Fehlermeldung wird zum 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 Gültigkeitsprüfungs exception 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 eines Formulars überprüft wird. Eine Gültigkeitsprüfungs exception is raised if the property is null, contains an empty string ("") or contains only white-space characters.

Hinweis

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

Konstruktoren

Name Beschreibung
RequiredAttribute()

Initialisiert eine neue Instanz der RequiredAttribute-Klasse.

Eigenschaften

Name Beschreibung
AllowEmptyStrings

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine leere Zeichenfolge zulässig ist.

ErrorMessage

Dient zum Abrufen oder Festlegen einer Fehlermeldung, die einem Überprüfungssteuerelement zugeordnet werden soll, wenn die Überprüfung fehlschlägt.

(Geerbt von ValidationAttribute)
ErrorMessageResourceName

Ruft den Namen der Fehlermeldungsressource ab, die verwendet werden soll, um den Eigenschaftswert nachzuschlagen, wenn die ErrorMessageResourceType Überprüfung fehlschlägt, oder legt diesen fest.

(Geerbt von ValidationAttribute)
ErrorMessageResourceType

Ruft den Ressourcentyp ab, der für die Fehlermeldungssuche verwendet werden soll, wenn die Überprüfung fehlschlägt, oder legt diesen fest.

(Geerbt von ValidationAttribute)
ErrorMessageString

Ruft die lokalisierte Überprüfungsfehlermeldung ab.

(Geerbt von ValidationAttribute)
RequiresValidationContext

Ruft einen Wert ab, der angibt, ob für das Attribut ein Überprüfungskontext erforderlich ist.

(Geerbt von ValidationAttribute)
TypeId

Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute.

(Geerbt von Attribute)

Methoden

Name Beschreibung
Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
FormatErrorMessage(String)

Wendet die Formatierung auf eine Fehlermeldung an, basierend auf dem Datenfeld, in dem der Fehler aufgetreten ist.

(Geerbt von ValidationAttribute)
GetHashCode()

Gibt den Hashcode für diesen instance zurück.

(Geerbt von Attribute)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValidationResult(Object, ValidationContext)

Überprüft, ob der angegebene Wert im Hinblick auf das aktuelle Überprüfungsattribut gültig ist.

(Geerbt von ValidationAttribute)
IsDefaultAttribute()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
IsValid(Object, ValidationContext)

Überprüft den angegebenen Wert im Hinblick auf das aktuelle Überprüfungsattribut.

(Geerbt von ValidationAttribute)
IsValid(Object)

Überprüft, ob der Wert des erforderlichen Datenfelds nicht leer ist.

Match(Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
Validate(Object, String)

Überprüft das angegebene Objekt.

(Geerbt von ValidationAttribute)
Validate(Object, ValidationContext)

Überprüft das angegebene Objekt.

(Geerbt von ValidationAttribute)

Explizite Schnittstellenimplementierungen

Name Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden.

(Geerbt von Attribute)

Gilt für: