RegularExpressionAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel.DataAnnotations

Zestaw:

System.ComponentModel.Annotations.dll

Źródło:

RegularExpressionAttribute.cs

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.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute

Public Class RegularExpressionAttribute
Inherits ValidationAttribute

Dziedziczenie

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Atrybuty

AttributeUsageAttribute

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)