StringLengthAttribute Класс

Ссылка

Определение

Пространство имен:: System.ComponentModel.DataAnnotations

Сборка:: System.ComponentModel.Annotations.dll

Сборки:: System.ComponentModel.Annotations.dll, System.ComponentModel.DataAnnotations.dll

Сборка:: System.ComponentModel.DataAnnotations.dll

Исходный код:: StringLengthAttribute.cs

Исходный код:: StringLengthAttribute.cs

Исходный код:: StringLengthAttribute.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Указывает минимальную и максимальную длину символов, разрешенных в поле данных.

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

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

Attribute

ValidationAttribute
StringLengthAttribute

Атрибуты: AttributeUsageAttribute

Примеры

В следующем примере показано, как ограничить количество символов в поле. Этот пример работает с полем 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 (создание, чтение, обновление и удаление) в модели данных. Можно указать минимальную и максимальную длину символов для каждого поля при вставке или обновлении данных. Для символьных типов данных свойства и MaximumLength определяют наибольшее количество байтов, MinimumLength необходимых для хранения строки.

Заполнители составного форматирования можно использовать в сообщении об ошибке: {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)	Определяет, является ли допустимым заданный объект.
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)

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