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.Specifies that a data field value in ASP.NET Dynamic Data must match the specified regular expression.

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
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
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 použít RegularExpressionAttribute atribut k ověření datových polí FirstName a LastName.The following example shows how to use the RegularExpressionAttribute attribute to validate the FirstName and LastName data fields. Regulární výraz umožňuje až 40 velkých a malých písmen.The regular expression allows up to 40 uppercase and lowercase characters. V příkladu se provádí následující úlohy:The example performs the following tasks:

  • Implementuje částečnou třídu metadat a přidruženou třídu metadat.Implements a metadata partial class and the associated metadata class.

  • V přidružené třídě metadat aplikuje RegularExpressionAttribute atribut na datová pole FirstName a LastName a určuje vzor a vlastní chybové zprávy.In the associated metadata class, applies the RegularExpressionAttribute attribute to the FirstName and LastName data fields, specifying the pattern and custom error messages.

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 pro vlastnost, pokud potřebujete ověřit hodnoty vlastnosti proti regulárnímu výrazu.You apply the RegularExpressionAttribute attribute to a property when you need to validate values for the property against a regular expression. Regulární výraz umožňuje přesně zadat formát platných hodnot.The regular expression enables you to specify very precisely the format of valid values. Vlastnost Pattern obsahuje regulární výraz.The Pattern property contains the regular expression. Pokud je hodnota vlastnosti null nebo prázdný řetězec (""), hodnota automaticky předá ověření pro atribut RegularExpressionAttribute.If the value of the property is null or an empty string (""), the value automatically passes validation for the RegularExpressionAttribute attribute. Chcete-li ověřit, zda hodnota není null nebo prázdným řetězcem, použijte atribut RequiredAttribute .To validate that the value is not null or an empty string, use the RequiredAttribute attribute.

Regulární výraz vyhledává přesnou shodu, nepoužívá-li se ^ před a $ na konci vzoru, vytváří stejné výsledky jako při jejich použití.The regular expression searches for an exact match, not using ^ before and $ at the end of the pattern produces the same results as using it. Pokud chcete hledat, předřaďte a přidejte vzor s .* .For a search hit, prepend and append the pattern with .*.

Konstruktory

RegularExpressionAttribute(String)

Inicializuje novou instanci RegularExpressionAttribute třídy.Initializes a new instance of the RegularExpressionAttribute class.

Vlastnosti

ErrorMessage

Získá nebo nastaví chybovou zprávu pro přidružení k ovládacímu prvku ověřování, pokud se ověření nepovede.Gets or sets an error message to associate with a validation control if validation fails.

(Zděděno od ValidationAttribute)
ErrorMessageResourceName

Získá nebo nastaví název prostředku chybové zprávy, který se má použít, aby se vyhledala hodnota vlastnosti v případě, že se ErrorMessageResourceType ověřování nezdařilo.Gets or sets the error message resource name to use in order to look up the ErrorMessageResourceType property value if validation fails.

(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í nepovede.Gets or sets the resource type to use for error-message lookup if validation fails.

(Zděděno od ValidationAttribute)
ErrorMessageString

Načte lokalizovanou chybovou zprávu ověření.Gets the localized validation error message.

(Zděděno od ValidationAttribute)
MatchTimeoutInMilliseconds

Získá nebo nastaví množství času v milisekundách, které spustí jednu operaci porovnání předtím, než vyprší časový limit operace.Gets or sets the amount of time in milliseconds to execute a single matching operation before the operation times out.

Pattern

Získá vzor regulárního výrazu.Gets the regular expression pattern.

RequiresValidationContext

Získá hodnotu, která označuje, zda atribut vyžaduje ověřovací kontext.Gets a value that indicates whether the attribute requires validation context.

(Zděděno od ValidationAttribute)
TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor Attribute .When implemented in a derived class, gets a unique identifier for this Attribute.

(Zděděno od Attribute)

Metody

Equals(Object)

Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu.Returns a value that indicates whether this instance is equal to a specified object.

(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řilo.Formats the error message to display if the regular expression validation fails.

GetHashCode()

Vrátí hodnotu hash pro tuto instanci.Returns the hash code for this instance.

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

Získá Type aktuální instanci.Gets the Type of the current instance.

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

Kontroluje, zda je zadaná hodnota platná vzhledem k aktuálnímu atributu ověřování.Checks whether the specified value is valid with respect to the current validation attribute.

(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.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

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

Kontroluje, zda hodnota zadaná uživatelem odpovídá vzoru regulárního výrazu.Checks whether the value entered by the user matches the regular expression pattern.

IsValid(Object, ValidationContext)

Ověří zadanou hodnotu vzhledem k aktuálnímu atributu ověřování.Validates the specified value with respect to the current validation attribute.

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

Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda je tato instance rovna zadanému objektu.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

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

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

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

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

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

Ověří zadaný objekt.Validates the specified object.

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

Ověří zadaný objekt.Validates the specified object.

(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í.Maps a set of names to a corresponding set of dispatch identifiers.

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

Načte informace o typu pro objekt, který lze použít k získání informací o typu pro rozhraní.Retrieves the type information for an object, which can be used to get the type information for an interface.

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

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).Retrieves the number of type information interfaces that an object provides (either 0 or 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.Provides access to properties and methods exposed by an object.

(Zděděno od Attribute)

Platí pro