StringLengthAttribute 类

定义

命名空间:

System.ComponentModel.DataAnnotations

程序集:

System.ComponentModel.Annotations.dll

Source:

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.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type StringLengthAttribute = class
    inherit ValidationAttribute

Public Class StringLengthAttribute
Inherits ValidationAttribute

继承

Object

Attribute

ValidationAttribute

StringLengthAttribute

属性

AttributeUsageAttribute

示例

以下示例演示如何限制字段中的字符数。 此示例使用 AdventureWorksLT 数据库的 Products 表中的 ThumbnailPhotoFileName 字段。 通过将 特性应用于 StringLengthAttribute 表示 Product 实体的分部类，字段限制为 4 个字符。

[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)	确定指定的对象是否有效。
IsValid(Object, ValidationContext)	根据当前的验证特性来验证指定的值。 (继承自 ValidationAttribute)
Match(Object)	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。 (继承自 Attribute)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
Validate(Object, String)	验证指定的对象。 (继承自 ValidationAttribute)
Validate(Object, ValidationContext)	验证指定的对象。 (继承自 ValidationAttribute)