RegularExpressionAttribute Třída

Definice

Určuje, že hodnota datového pole v ASP.NET Dynamická data musí odpovídat zadanému regulárnímu výrazu.

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
Dědičnost
RegularExpressionAttribute
Atributy

Příklady

Následující příklad ukazuje, jak pomocí atributu RegularExpressionAttribute ověřit datová pole Jméno a Příjmení. Regulární výraz umožňuje až 40 velkých a malých písmen. Příklad provádí následující úlohy:

  • Implementuje částečnou třídu metadat a přidruženou třídu metadat.

  • V přidružené třídě metadat použije RegularExpressionAttribute atribut na datová pole FirstName a LastName a určí vzor a vlastní chybové zprávy.

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

Poznámky

Použít RegularExpressionAttribute atribut na vlastnost, když potřebujete ověřit hodnoty vlastnosti proti regulární výraz. Regulární výraz umožňuje zadat velmi přesný formát platných hodnot. Vlastnost Pattern obsahuje regulární výraz. Pokud je hodnota vlastnosti null nebo prázdný řetězec (""), hodnota automaticky projde ověřením regularExpressionAttribute atribut. Pokud chcete ověřit, že hodnota není null nebo prázdný řetězec, použijte atribut RequiredAttribute .

Regulární výraz hledá přesnou shodu. Použití ^ před a $ na konci vzoru nevygeneruje stejné výsledky jako jeho použití. Pokud chcete najít hledání, předpřidejte vzor a připojte ho pomocí .*.

Konstruktory

RegularExpressionAttribute(String)

Inicializuje novou instanci RegularExpressionAttribute třídy .

Vlastnosti

ErrorMessage

Získá nebo nastaví chybovou zprávu, která se přidruží k ověřovacímu ovládacímu prvku, pokud ověření selže.

(Zděděno od ValidationAttribute)
ErrorMessageResourceName

Získá nebo nastaví název prostředku chybové zprávy, který se použije k vyhledání ErrorMessageResourceType hodnoty vlastnosti, pokud ověření selže.

(Zděděno od ValidationAttribute)
ErrorMessageResourceType

Získá nebo nastaví typ prostředku, který se má použít pro vyhledávání chybových zpráv, pokud se ověření nezdaří.

(Zděděno od ValidationAttribute)
ErrorMessageString

Získá lokalizovanou ověřovací chybovou zprávu.

(Zděděno od ValidationAttribute)
MatchTimeout

Získá časový limit, který se má použít při porovnávání vzoru regulárního výrazu.

MatchTimeoutInMilliseconds

Získá nebo nastaví dobu v milisekundách k provedení jedné odpovídající operace před vypršením časového limitu operace.

Pattern

Získá vzor regulárního výrazu.

RequiresValidationContext

Získá hodnotu, která označuje, zda atribut vyžaduje kontext ověření.

(Zděděno od ValidationAttribute)
TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu .

(Zděděno od Attribute)

Metody

Equals(Object)

Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu.

(Zděděno od Attribute)
FormatErrorMessage(String)

Formátuje chybovou zprávu, která se zobrazí, pokud se ověření regulárního výrazu nezdaří.

GetHashCode()

Vrátí hodnotu hash pro tuto instanci.

(Zděděno od Attribute)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
GetValidationResult(Object, ValidationContext)

Zkontroluje, zda je zadaná hodnota platná s ohledem na aktuální ověřovací atribut.

(Zděděno od ValidationAttribute)
IsDefaultAttribute()

Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu.

(Zděděno od Attribute)
IsValid(Object)

Zkontroluje, jestli hodnota zadaná uživatelem odpovídá vzoru regulárního výrazu.

IsValid(Object, ValidationContext)

Ověří zadanou hodnotu s ohledem na aktuální ověřovací atribut.

(Zděděno od ValidationAttribute)
Match(Object)

Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu.

(Zděděno od Attribute)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
Validate(Object, String)

Ověří zadaný objekt.

(Zděděno od ValidationAttribute)
Validate(Object, ValidationContext)

Ověří zadaný objekt.

(Zděděno od ValidationAttribute)

Explicitní implementace rozhraní

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

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu objektu, které lze použít k získání informací o typu pro rozhraní.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.

(Zděděno od Attribute)

Platí pro