RegularExpressionAttribute Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- 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) |