RegularExpressionAttribute Osztály

Definíció

Névtér:

System.ComponentModel.DataAnnotations

Szerelvény:

System.ComponentModel.Annotations.dll

Forrás:

RegularExpressionAttribute.cs

Azt határozza meg, hogy a dinamikus adatok ASP.NET adatmező-értékének meg kell egyeznie a megadott reguláris kifejezéssel.

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

Öröklődés

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa bemutatja, hogyan használható az attribútum a RegularExpressionAttribute FirstName és a LastName adatmezők ellenőrzésére. A reguláris kifejezés legfeljebb 40 kis- és nagybetűt tesz lehetővé. A példa a következő feladatokat hajtja végre:

• Metaadatok részleges osztályát és a társított metaadatosztályt implementálja.
• A társított metaadatosztályban alkalmazza az RegularExpressionAttribute attribútumot a FirstName és a LastName adatmezőkre, megadva a mintát és az egyéni hibaüzeneteket.

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

Megjegyzések

A RegularExpressionAttribute attribútumot akkor alkalmazza egy tulajdonságra, ha a tulajdonság értékeit egy reguláris kifejezéssel kell ellenőriznie. A reguláris kifejezéssel nagyon pontosan megadhatja az érvényes értékek formátumát. A Minta tulajdonság a reguláris kifejezést tartalmazza. Ha a tulajdonság értéke null vagy üres sztring (""), az érték automatikusan megfelel a RegularExpressionAttribute attribútum érvényesítésének. Annak ellenőrzéséhez, hogy az érték nem null vagy egy üres sztring, használja a RequiredAttribute attribútumot .

A reguláris kifejezés pontos egyezést keres, a minta előtt és ^ végén nem használva $ ugyanazokat az eredményeket hozza létre, mint a használata. Keresési találat esetén előre fel kell függesztetni és hozzáfűzni a mintát a következőhöz .*: .

Konstruktorok

Name	Description
RegularExpressionAttribute(String)	Inicializálja a RegularExpressionAttribute osztály új példányát.

Tulajdonságok

Name	Description
ErrorMessage	Ha az ellenőrzés sikertelen, hibaüzenetet kap vagy állít be egy érvényesítési vezérlőhöz való társításhoz. (Öröklődés forrása ValidationAttribute)
ErrorMessageResourceName	Lekéri vagy beállítja a hibaüzenet erőforrásnevét a tulajdonság értékének kereséséhez, ha az ErrorMessageResourceType ellenőrzés sikertelen. (Öröklődés forrása ValidationAttribute)
ErrorMessageResourceType	Lekéri vagy beállítja az erőforrástípust a hibaüzenetek kereséséhez, ha az ellenőrzés sikertelen. (Öröklődés forrása ValidationAttribute)
ErrorMessageString	Lekéri a honosított érvényesítési hibaüzenetet. (Öröklődés forrása ValidationAttribute)
MatchTimeout	Lekéri a normál kifejezésmintának megfelelő időtúllépést
MatchTimeoutInMilliseconds	Ezredmásodpercben lekéri vagy beállítja az egyetlen egyező művelet végrehajtásához szükséges időt, mielőtt a művelet túllépi az időkorlátot.
Pattern	Lekéri a reguláris kifejezésmintát.
RequiresValidationContext	Olyan értéket kap, amely jelzi, hogy az attribútumhoz érvényesítési környezet szükséges-e. (Öröklődés forrása ValidationAttribute)
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
FormatErrorMessage(String)	Formázhatja a hibaüzenetet úgy, hogy megjelenjen, ha a reguláris kifejezés érvényesítése sikertelen.
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetValidationResult(Object, ValidationContext)	Ellenőrzi, hogy a megadott érték érvényes-e az aktuális érvényesítési attribútumra vonatkozóan. (Öröklődés forrása ValidationAttribute)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
IsValid(Object, ValidationContext)	Ellenőrzi a megadott értéket az aktuális érvényesítési attribútummal kapcsolatban. (Öröklődés forrása ValidationAttribute)
IsValid(Object)	Ellenőrzi, hogy a felhasználó által megadott érték megegyezik-e a reguláris kifejezésmintával.
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
Validate(Object, String)	Ellenőrzi a megadott objektumot. (Öröklődés forrása ValidationAttribute)
Validate(Object, ValidationContext)	Ellenőrzi a megadott objektumot. (Öröklődés forrása ValidationAttribute)

Lásd még

• .NET reguláris kifejezések