StringLengthAttribute Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает минимальную и максимальную длину символов, разрешенных в поле данных.
public ref class StringLengthAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class StringLengthAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class StringLengthAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type StringLengthAttribute = class
inherit ValidationAttribute
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type StringLengthAttribute = class
inherit ValidationAttribute
Public Class StringLengthAttribute
Inherits ValidationAttribute
- Наследование
- Атрибуты
Примеры
В следующем примере показано, как ограничить количество символов в поле. Этот пример работает с полем ThumbnailPhotoFileName в таблице Products в базе данных AdventureWorksLT. Поле ограничено 4 символами, применяя StringLengthAttribute атрибут к частичному классу, представляющего сущность Product.
[MetadataType(typeof(ProductMetadata))]
public partial class Product
{
}
public class ProductMetadata
{
[ScaffoldColumn(true)]
[StringLength(4, ErrorMessage = "The ThumbnailPhotoFileName value cannot exceed 4 characters. ")]
public object ThumbnailPhotoFileName;
[ScaffoldColumn(true)]
[StringLength(4, ErrorMessage = "The {0} value cannot exceed {1} characters. ")]
public object PhotoFileName;
}
<MetadataType(GetType(ProductMetadata))> _
Public Partial Class Product
End Class
Public Class ProductMetadata
<ScaffoldColumn(True)> _
<StringLength(4, ErrorMessage := "The ThumbnailPhotoFileName value cannot exceed 4 characters. ")> _
Public ThumbnailPhotoFileName As Object
<ScaffoldColumn(True)> _
<StringLength(4, ErrorMessage := "The {0} value cannot exceed {1} characters. ")> _
Public PhotoFileName As Object
End Class
Комментарии
ASP.NET динамические данные позволяют выполнять операции CRUD (создание, чтение, обновление и удаление) в модели данных. Можно указать минимальную и максимальную длину символов для каждого поля при вставке или обновлении данных. Для типов MinimumLength символьных данных свойства MaximumLength определяют наибольшее количество байтов, необходимых для хранения строки.
Заполнители составного форматирования можно использовать в сообщении об ошибке: {0} имя свойства; {1} максимальная длина и {2} минимальная длина. Заполнители соответствуют аргументам, передаваемым методу String.Format во время выполнения.
Конструкторы
| Имя | Описание |
|---|---|
| StringLengthAttribute(Int32) |
Инициализирует новый экземпляр класса с помощью указанной StringLengthAttribute максимальной длины. |
Свойства
| Имя | Описание |
|---|---|
| ErrorMessage |
Возвращает или задает сообщение об ошибке для связывания с элементом управления проверки, если проверка завершается ошибкой. (Унаследовано от ValidationAttribute) |
| ErrorMessageResourceName |
Возвращает или задает имя ресурса сообщения об ошибке для поиска ErrorMessageResourceType значения свойства, если проверка завершается ошибкой. (Унаследовано от ValidationAttribute) |
| ErrorMessageResourceType |
Возвращает или задает тип ресурса, используемый для поиска сообщений об ошибке, если проверка завершается ошибкой. (Унаследовано от ValidationAttribute) |
| ErrorMessageString |
Возвращает локализованное сообщение об ошибке проверки. (Унаследовано от ValidationAttribute) |
| MaximumLength |
Возвращает или задает максимальную длину строки. |
| MinimumLength |
Возвращает или задает минимальную длину строки. |
| 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) |