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 pole FirstName a LastName datová pole. Regulární výraz umožňuje až 40 velkých a malých znaků. Příklad provádí následující úlohy:

  • Implementuje částečnou třídu metadat a přidruženou třídu metadat.
  • Ve třídě přidružených metadat použije RegularExpressionAttribute atribut u datových polí FirstName a LastName a určuje 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

Atribut RegularExpressionAttribute použijete na vlastnost, pokud potřebujete ověřit hodnoty pro vlastnost proti regulárnímu výrazu. Regulární výraz umožňuje přesně určit formát platných hodnot. Vlastnost Pattern obsahuje regulární výraz. Pokud je hodnota vlastnosti null nebo prázdný řetězec (""), hodnota automaticky předává ověření pro RegularExpressionAttribute atribut. Pokud chcete ověřit, že hodnota není null nebo prázdný řetězec, použijte atribut RequiredAttribute .

Regulární výraz vyhledá přesnou shodu, nikoli před ^ a $ na konci vzoru, vytvoří stejné výsledky jako při jeho použití. Pro hledaný hit, předpend a připojte vzor s .*.

Konstruktory

Name Description
RegularExpressionAttribute(String)

Inicializuje novou instanci RegularExpressionAttribute třídy.

Vlastnosti

Name Description
ErrorMessage

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

(Zděděno od ValidationAttribute)
ErrorMessageResourceName

Získá nebo nastaví název prostředku chybové zprávy použít k vyhledání ErrorMessageResourceType hodnoty vlastnosti v případě selhání ověření.

(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 ke spuštění 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 tento Attribute.

(Zděděno od Attribute)

Metody

Name Description
Equals(Object)

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

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

Naformátuje chybovou zprávu, aby se zobrazila, pokud ověření regulárního výrazu selže.

GetHashCode()

Vrátí kód hash pro tuto instanci.

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

Získá Type 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ě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu.

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

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

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

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

Match(Object)

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

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

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

(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í

Name Description
_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

Viz také