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 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) |