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 danych dynamicznych musi być zgodna 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. Przykład wykonuje następujące zadania:

• Implementuje klasę częściową metadanych i skojarzoną 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 musisz zweryfikować wartości właściwości względem wyrażenia regularnego. Wyrażenie regularne umożliwia określenie bardzo precyzyjnego 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, nie jest używane ^ przed i $ na końcu wzorca generuje takie same wyniki, jak przy użyciu. W przypadku trafienia wyszukiwania, wstępnego 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, który ma być skojarzony z kontrolką walidacji, jeśli walidacja nie powiedzie się. (Odziedziczone po ValidationAttribute)
ErrorMessageResourceName	Pobiera lub ustawia nazwę zasobu komunikatu o błędzie, która ma być używana w celu wyszukania ErrorMessageResourceType wartości właściwości w przypadku niepowodzenia walidacji. (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 używany podczas dopasowywania wzorca wyrażenia regularnego
MatchTimeoutInMilliseconds	Pobiera lub ustawia czas w milisekundach, aby wykonać pojedynczą operację dopasowania 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 elementu Attribute. (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 bieżące wystąpienie. (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()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną 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 walidacji. (Odziedziczone po ValidationAttribute)
Match(Object)	W przypadku zastąpienia 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)	Weryfikuje określony obiekt. (Odziedziczone po ValidationAttribute)
Validate(Object, ValidationContext)	Weryfikuje określony obiekt. (Odziedziczone po ValidationAttribute)