RegularExpressionAttribute Класс

Определение

Пространство имен:

System.ComponentModel.DataAnnotations

Сборка:

System.ComponentModel.Annotations.dll

Исходный код:

RegularExpressionAttribute.cs

Указывает, что значение поля данных в платформе динамических данных ASP.NET должно соответствовать заданному регулярному выражению.

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

Наследование

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере показано, как использовать RegularExpressionAttribute атрибут для проверки полей данных FirstName и LastName. Регулярное выражение допускает до 40 символов в верхнем и нижнем регистре. В этом примере выполняются следующие задачи:

• Реализует разделяемый класс метаданных и связанный класс метаданных.

• В связанном классе метаданных применяет RegularExpressionAttribute атрибут к полям данных FirstName и LastName, указывая шаблон и пользовательские сообщения об ошибках.

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

Комментарии

Атрибут RegularExpressionAttribute применяется к свойству, когда необходимо проверить значения свойства по регулярному выражению. Регулярное выражение позволяет очень точно указать формат допустимых значений. Свойство Pattern содержит регулярное выражение. Если значение свойства равно NULL или пустой строке (""), значение автоматически проходит проверку атрибута RegularExpressionAttribute. Чтобы убедиться, что значение не null является или является пустой строкой, используйте атрибут RequiredAttribute .

Регулярное выражение ищет точное совпадение, не используя ^ до и в конце шаблона, дает те же результаты, что и $ при его использовании. Чтобы выполнить поиск, добавьте шаблон с .*помощью .

Конструкторы

RegularExpressionAttribute(String)

Инициализирует новый экземпляр класса RegularExpressionAttribute.

Свойства

ErrorMessage	Получает или задает сообщение об ошибке, которое необходимо связать с проверяющим элементом управления на случай сбоя во время проверки. (Унаследовано от ValidationAttribute)
ErrorMessageResourceName	Получает или задает имя ресурса сообщений об ошибках, используемого для поиска значения свойства ErrorMessageResourceType в случае сбоя при проверке. (Унаследовано от ValidationAttribute)
ErrorMessageResourceType	Получает или задает тип ресурса, используемого для поиска сообщения об ошибке в случае сбоя проверки. (Унаследовано от ValidationAttribute)
ErrorMessageString	Получает локализованное сообщение об ошибке проверки. (Унаследовано от ValidationAttribute)
MatchTimeout	Возвращает время ожидания, используемое при сопоставлении шаблона регулярного выражения.
MatchTimeoutInMilliseconds	Возвращает или задает количество времени в миллисекундах для выполнения одной операции сопоставления до истечения времени ожидания операции.
Pattern	Получает шаблон регулярного выражения.
RequiresValidationContext	Получает значение, указывающее, требует ли атрибут контекста проверки. (Унаследовано от ValidationAttribute)
TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
FormatErrorMessage(String)	Форматирует сообщение об ошибке, отображаемое, если во время проверки регулярного выражения произойдет сбой.
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValidationResult(Object, ValidationContext)	Проверяет, является ли заданное значение допустимым относительно текущего атрибута проверки. (Унаследовано от ValidationAttribute)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
IsValid(Object)	Проверяет, соответствует ли введенное пользователем значение шаблону регулярного выражения.
IsValid(Object, ValidationContext)	Проверяет заданное значение относительно текущего атрибута проверки. (Унаследовано от ValidationAttribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Validate(Object, String)	Проверяет указанный объект. (Унаследовано от ValidationAttribute)
Validate(Object, ValidationContext)	Проверяет указанный объект. (Унаследовано от ValidationAttribute)