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 атрибут для проверки полей данных 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) |