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

Проверяет указанное значение относительно текущего атрибута проверки.

(Унаследовано от ValidationAttribute)
IsValid(Object)

Проверяет, соответствует ли значение, введенное пользователем, шаблону регулярного выражения.

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)

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

См. также раздел