RegularExpressionAttribute Klass

Definition

Anger att ett datafältvärde i ASP.NET dynamiska data måste matcha det angivna reguljära uttrycket.

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
Arv
RegularExpressionAttribute
Attribut

Exempel

I följande exempel visas hur du använder RegularExpressionAttribute attributet för att verifiera datafälten FirstName och LastName. Det reguljära uttrycket tillåter upp till 40 versaler och gemener. Exemplet utför följande uppgifter:

  • Implementerar en partiell metadataklass och den associerade metadataklassen.
  • I den associerade metadataklassen RegularExpressionAttribute tillämpar du attributet på datafälten FirstName och LastName och anger mönstret och anpassade felmeddelanden.
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

Kommentarer

Du tillämpar attributet RegularExpressionAttribute på en egenskap när du behöver verifiera värden för egenskapen mot ett reguljärt uttryck. Med det reguljära uttrycket kan du ange exakt formatet för giltiga värden. Egenskapen Pattern innehåller det reguljära uttrycket. Om värdet för egenskapen är null eller en tom sträng (") godkänns automatiskt valideringen för attributet RegularExpressionAttribute. Om du vill verifiera att värdet inte null är eller en tom sträng använder du attributet RequiredAttribute .

Det reguljära uttrycket söker efter en exakt matchning, utan att använda ^ före och $ i slutet av mönstret, vilket ger samma resultat som när det används. För en sökträff förbereder du och lägger till mönstret med .*.

Konstruktorer

Name Description
RegularExpressionAttribute(String)

Initierar en ny instans av RegularExpressionAttribute klassen.

Egenskaper

Name Description
ErrorMessage

Hämtar eller anger ett felmeddelande som ska associeras med en verifieringskontroll om verifieringen misslyckas.

(Ärvd från ValidationAttribute)
ErrorMessageResourceName

Hämtar eller anger det felmeddelande som resursnamnet ska användas för att söka efter egenskapsvärdet om verifieringen ErrorMessageResourceType misslyckas.

(Ärvd från ValidationAttribute)
ErrorMessageResourceType

Hämtar eller anger den resurstyp som ska användas för felmeddelandesökning om verifieringen misslyckas.

(Ärvd från ValidationAttribute)
ErrorMessageString

Hämtar det lokaliserade valideringsfelmeddelandet.

(Ärvd från ValidationAttribute)
MatchTimeoutInMilliseconds

Hämtar eller anger hur lång tid i millisekunder som ska köra en enskild matchningsåtgärd innan åtgärden överskrider tidsgränsen.

Pattern

Hämtar mönster för reguljära uttryck.

RequiresValidationContext

Hämtar ett värde som anger om attributet kräver verifieringskontext.

(Ärvd från ValidationAttribute)
TypeId

När den implementeras i en härledd klass hämtar du en unik identifierare för den här Attribute.

(Ärvd från Attribute)

Metoder

Name Description
Equals(Object)

Returnerar ett värde som anger om den här instansen är lika med ett angivet objekt.

(Ärvd från Attribute)
FormatErrorMessage(String)

Formaterar felmeddelandet så att det visas om valideringen av reguljära uttryck misslyckas.

GetHashCode()

Returnerar hash-koden för den här instansen.

(Ärvd från Attribute)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
GetValidationResult(Object, ValidationContext)

Kontrollerar om det angivna värdet är giltigt med avseende på det aktuella valideringsattributet.

(Ärvd från ValidationAttribute)
IsDefaultAttribute()

När den åsidosättas i en härledd klass anger du om värdet för den här instansen är standardvärdet för den härledda klassen.

(Ärvd från Attribute)
IsValid(Object, ValidationContext)

Validerar det angivna värdet med avseende på det aktuella valideringsattributet.

(Ärvd från ValidationAttribute)
IsValid(Object)

Kontrollerar om det värde som användaren anger matchar mönstret för reguljära uttryck.

Match(Object)

När den åsidosätts i en härledd klass returneras ett värde som anger om den här instansen är lika med ett angivet objekt.

(Ärvd från Attribute)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
Validate(Object, String)

Verifierar det angivna objektet.

(Ärvd från ValidationAttribute)
Validate(Object, ValidationContext)

Verifierar det angivna objektet.

(Ärvd från ValidationAttribute)

Explicita gränssnittsimplementeringar

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

Mappar en uppsättning namn till en motsvarande uppsättning av sändningsidentifierare.

(Ärvd från Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Hämtar typinformationen för ett objekt, som kan användas för att hämta typinformationen för ett gränssnitt.

(Ärvd från Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Hämtar antalet typinformationsgränssnitt som ett objekt tillhandahåller (antingen 0 eller 1).

(Ärvd från Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Ger åtkomst till egenskaper och metoder som exponeras av ett objekt.

(Ärvd från Attribute)

Gäller för

Se även