RegularExpressionAttribute Klasse

Definition

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Quelle:

RegularExpressionAttribute.cs

Gibt an, dass ein Datenfeldwert in ASP.NET Dynamic Data mit dem angegebenen regulären Ausdruck übereinstimmen muss.

public ref class RegularExpressionAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class RegularExpressionAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute

Public Class RegularExpressionAttribute
Inherits ValidationAttribute

Vererbung

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Attribute

AttributeUsageAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie das RegularExpressionAttribute Attribut verwenden, um die Datenfelder FirstName und LastName zu überprüfen. Der reguläre Ausdruck lässt bis zu 40 Groß- und Kleinbuchstaben zu. Das Beispiel führt die folgenden Aufgaben aus:

• Implementiert eine partielle Metadatenklasse und die zugehörige Metadatenklasse.

• Wendet in der zugeordneten Metadatenklasse das Attribut auf die RegularExpressionAttribute Datenfelder FirstName und LastName an, wobei das Muster und benutzerdefinierte Fehlermeldungen angegeben werden.

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;

[MetadataType(typeof(CustomerMetaData))]
public partial class Customer
{
}

public class CustomerMetaData
{
   
    // Allow up to 40 uppercase and lowercase 
    // characters. Use custom error.
    [RegularExpression(@"^[a-zA-Z''-'\s]{1,40}$", 
         ErrorMessage = "Characters are not allowed.")]
    public object FirstName;

    // Allow up to 40 uppercase and lowercase 
    // characters. Use standard error.
    [RegularExpression(@"^[a-zA-Z''-'\s]{1,40}$")]
    public object LastName;
}

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations


<MetadataType(GetType(CustomerMetaData))> _
Partial Public Class Customer

    
End Class

Public Class CustomerMetaData
    
    ' Allow up to 40 uppercase and lowercase 
    ' characters. Use custom error.
    <RegularExpression("^[a-zA-Z''-'\s]{1,40}$", _
                       ErrorMessage:="Characters are not allowed.")> _
    Public FirstName As Object

    ' Allow up to 40 uppercase and lowercase 
    ' characters. Use standard error.
    <RegularExpression("^[a-zA-Z''-'\s]{1,40}$")> _
    Public LastName As Object
End Class

Hinweise

Sie wenden das RegularExpressionAttribute-Attribut auf eine Eigenschaft an, wenn Sie Werte für die Eigenschaft mit einem regulären Ausdruck überprüfen müssen. Mit dem regulären Ausdruck können Sie das Format gültiger Werte sehr genau angeben. Die Pattern-Eigenschaft enthält den regulären Ausdruck. Wenn der Wert der Eigenschaft NULL oder eine leere Zeichenfolge ("") ist, besteht der Wert automatisch die Überprüfung für das RegularExpressionAttribute-Attribut. Um zu überprüfen, ob der Wert nicht null oder eine leere Zeichenfolge ist, verwenden Sie das RequiredAttribute-Attribut .

Der reguläre Ausdruck sucht nach einer genauen Übereinstimmung, wobei die Verwendung ^ vor und $ am Ende des Musters die gleichen Ergebnisse wie die Verwendung des Musters erzeugt. Fügen Sie für einen Suchtreffer das Muster voran, und fügen Sie es mit .*an.

Konstruktoren

RegularExpressionAttribute(String)

Initialisiert eine neue Instanz der RegularExpressionAttribute-Klasse.

Eigenschaften

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)
MatchTimeout	Ruft das Timeout ab, das beim Übereinstimmen mit dem Muster für reguläre Ausdrücke verwendet werden soll.
MatchTimeoutInMilliseconds	Dient zum Abrufen oder Festlegen des Zeitraums in Millisekunden zum Ausführen eines einzelnen Übereinstimmungsvorgangs, ehe das Zeitlimit des Vorgangs überschritten wird.
Pattern	Ruft das Muster des regulären Ausdrucks ab.
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)	Formatiert die anzuzeigende Fehlermeldung, wenn die Validierung des regulären Ausdrucks fehlschlägt.
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, ob der vom Benutzer eingegebene Wert mit dem Muster des regulären Ausdrucks übereinstimmt.
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)