Udostępnij za pośrednictwem


RegularExpressionAttribute Klasa

Definicja

Określa, że wartość pola danych w ASP.NET dane dynamiczne muszą być zgodne z określonym wyrażeniem regularnym.

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.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
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute
Public Class RegularExpressionAttribute
Inherits ValidationAttribute
Dziedziczenie
RegularExpressionAttribute
Atrybuty

Przykłady

W poniższym przykładzie pokazano, jak używać atrybutu RegularExpressionAttribute do sprawdzania poprawności pól danych FirstName i LastName. Wyrażenie regularne umożliwia maksymalnie 40 wielkich i małych liter. W przykładzie są wykonywane następujące zadania:

  • Implementuje klasę częściową metadanych i skojarzą klasę metadanych.

  • W skojarzonej klasie metadanych stosuje RegularExpressionAttribute atrybut do pól danych FirstName i LastName, określając wzorzec i niestandardowe komunikaty o błędach.

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

Uwagi

Atrybut RegularExpressionAttribute stosuje się do właściwości, gdy trzeba zweryfikować wartości właściwości względem wyrażenia regularnego. Wyrażenie regularne umożliwia określenie bardzo dokładnego formatu prawidłowych wartości. Właściwość Pattern zawiera wyrażenie regularne. Jeśli wartość właściwości ma wartość null lub pusty ciąg (""), wartość automatycznie przechodzi walidację atrybutu RegularExpressionAttribute. Aby sprawdzić, czy wartość nie null jest ciągiem pustym, użyj atrybutu RequiredAttribute .

Wyrażenie regularne wyszukuje dokładne dopasowanie, a nie przy użyciu ^ wartości przed i $ na końcu wzorca, generuje te same wyniki, co użycie go. W przypadku trafienia wyszukiwania dodaj i dołącz wzorzec za pomocą .*polecenia .

Konstruktory

RegularExpressionAttribute(String)

Inicjuje nowe wystąpienie klasy RegularExpressionAttribute.

Właściwości

ErrorMessage

Pobiera lub ustawia komunikat o błędzie do skojarzenia z kontrolką weryfikacji, jeśli walidacja nie powiedzie się.

(Odziedziczone po ValidationAttribute)
ErrorMessageResourceName

Pobiera lub ustawia nazwę zasobu komunikatu o błędzie do użycia w celu wyszukania ErrorMessageResourceType wartości właściwości, jeśli walidacja nie powiedzie się.

(Odziedziczone po ValidationAttribute)
ErrorMessageResourceType

Pobiera lub ustawia typ zasobu, który ma być używany do wyszukiwania komunikatów o błędzie, jeśli walidacja nie powiedzie się.

(Odziedziczone po ValidationAttribute)
ErrorMessageString

Pobiera zlokalizowany komunikat o błędzie weryfikacji.

(Odziedziczone po ValidationAttribute)
MatchTimeout

Pobiera limit czasu do użycia podczas dopasowywania wzorca wyrażenia regularnego

MatchTimeoutInMilliseconds

Pobiera lub ustawia czas w milisekundach, aby wykonać pojedynczą pasującą operację przed przekroczeniem limitu czasu operacji.

Pattern

Pobiera wzorzec wyrażenia regularnego.

RequiresValidationContext

Pobiera wartość wskazującą, czy atrybut wymaga kontekstu weryfikacji.

(Odziedziczone po ValidationAttribute)
TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu .

(Odziedziczone po Attribute)

Metody

Equals(Object)

Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi.

(Odziedziczone po Attribute)
FormatErrorMessage(String)

Formatuje komunikat o błędzie wyświetlany, jeśli walidacja wyrażenia regularnego zakończy się niepowodzeniem.

GetHashCode()

Zwraca wartość skrótu dla tego wystąpienia.

(Odziedziczone po Attribute)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
GetValidationResult(Object, ValidationContext)

Sprawdza, czy określona wartość jest prawidłowa w odniesieniu do bieżącego atrybutu weryfikacji.

(Odziedziczone po ValidationAttribute)
IsDefaultAttribute()

Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej.

(Odziedziczone po Attribute)
IsValid(Object)

Sprawdza, czy wartość wprowadzona przez użytkownika jest zgodna ze wzorcem wyrażenia regularnego.

IsValid(Object, ValidationContext)

Weryfikuje określoną wartość w odniesieniu do bieżącego atrybutu weryfikacji.

(Odziedziczone po ValidationAttribute)
Match(Object)

Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi.

(Odziedziczone po Attribute)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
Validate(Object, String)

Sprawdza poprawność określonego obiektu.

(Odziedziczone po ValidationAttribute)
Validate(Object, ValidationContext)

Sprawdza poprawność określonego obiektu.

(Odziedziczone po ValidationAttribute)

Jawne implementacje interfejsu

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

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).

(Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt.

(Odziedziczone po Attribute)

Dotyczy