RegularExpressionAttribute Klasse

Definition

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.DataAnnotations.dll

Gibt an, dass ein Datenfeldwert in ASP.NET Dynamische Daten 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 "Vorname" und "Nachname" zu überprüfen. Der reguläre Ausdruck ermöglicht bis zu 40 Groß- und Kleinbuchstaben. Im Beispiel werden die folgenden Aufgaben ausgeführt:

• Implementiert eine partielle Metadatenklasse und die zugeordnete Metadatenklasse.
• Wendet in der zugeordneten Metadatenklasse das RegularExpressionAttribute Attribut auf die Datenfelder "FirstName" und "LastName" an, wobei das Muster und die benutzerdefinierten 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 anhand eines regulären Ausdrucks ü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, übergibt 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, die nicht vor und $ am Ende des Musters verwendet ^ wird, erzeugt dieselben Ergebnisse wie die Verwendung. Stellen Sie für einen Suchtreffer das Muster voran, und fügen Sie es mit .*an.

Konstruktoren

Name	Beschreibung
RegularExpressionAttribute(String)	Initialisiert eine neue Instanz der RegularExpressionAttribute-Klasse.

Eigenschaften

Name	Beschreibung
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)
MatchTimeoutInMilliseconds	Ruft die Zeitspanne in Millisekunden ab, um einen einzelnen Abgleichsvorgang auszuführen, bevor der Vorgang zu einem Timeout führt, oder legt diesen fest.
Pattern	Ruft das Muster für reguläre Ausdrücke ab.
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)	Formatiert die Fehlermeldung so, dass angezeigt wird, wenn die Überprüfung des regulären Ausdrucks fehlschlägt.
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 vom Benutzer eingegebene Wert mit dem Muster für reguläre Ausdrücke übereinstimmt.
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)

Weitere Informationen

• Reguläre Ausdrücke in .NET