RegularExpressionAttribute Класс

Определение

Указывает, что значение поля данных в платформе динамических данных 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.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
Наследование
RegularExpressionAttribute
Атрибуты

Примеры

В следующем примере показано, как использовать 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)

Явные реализации интерфейса

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

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.

(Унаследовано от Attribute)

Применяется к