StringLengthAttribute Classe

Definição

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Origem:

StringLengthAttribute.cs

Especifica o comprimento mínimo e máximo de caracteres permitidos em um campo de dados.

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

Herança

Object

Attribute

ValidationAttribute

StringLengthAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra como limitar o número de caracteres em um campo. Este exemplo funciona com o campo ThumbnailPhotoFileName na tabela Products no banco de dados AdventureWorksLT. O campo tem 4 caracteres limitados aplicando o StringLengthAttribute atributo à classe parcial que representa a entidade 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  

Comentários

ASP.NET Dados Dinâmicos habilita operações CRUD (Criar, Ler, Atualizar e Excluir) em um modelo de dados. Você pode especificar o comprimento mínimo e máximo de caracteres para cada campo quando os dados estiverem sendo inseridos ou atualizados. Para tipos de dados de caracteres, as MinimumLength propriedades e MaximumLength identificam o maior número de bytes necessários para armazenar uma cadeia de caracteres.

Você pode usar espaços reservados de formatação composta na mensagem de erro: {0} é o nome da propriedade; {1} é o comprimento máximo; e {2} é o comprimento mínimo. Os espaços reservados correspondem aos argumentos passados para o String.Format método em runtime.

Construtores

StringLengthAttribute(Int32)

Inicializa uma nova instância da classe StringLengthAttribute usando um comprimento máximo especificado.

Propriedades

ErrorMessage	Obtém ou define uma mensagem de erro para associar a um controle de validação em caso de falha da validação. (Herdado de ValidationAttribute)
ErrorMessageResourceName	Obtém ou define o nome do recurso de mensagem de erro a ser usado para pesquisar o valor da propriedade ErrorMessageResourceType se a validação falhar. (Herdado de ValidationAttribute)
ErrorMessageResourceType	Obtém ou define o tipo de recurso a ser usado para a pesquisa de mensagens de erro se a validação falhar. (Herdado de ValidationAttribute)
ErrorMessageString	Obtém a mensagem de erro de validação localizada. (Herdado de ValidationAttribute)
MaximumLength	Obtém ou define o tamanho máximo de uma cadeia de caracteres.
MinimumLength	Obtém ou define o tamanho mínimo de uma cadeia de caracteres.
RequiresValidationContext	Obtém ou define um valor que indica se o atributo requer contexto de validação. (Herdado de ValidationAttribute)
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
FormatErrorMessage(String)	Aplica formatação a uma mensagem de erro especificada.
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValidationResult(Object, ValidationContext)	Verifica se o valor especificado é válido em relação ao atributo de validação atual. (Herdado de ValidationAttribute)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
IsValid(Object)	Determina se um objeto especificado é válido.
IsValid(Object, ValidationContext)	Valida o valor especificado em relação ao atributo de validação atual. (Herdado de ValidationAttribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Validate(Object, String)	Valida o objeto especificado. (Herdado de ValidationAttribute)
Validate(Object, ValidationContext)	Valida o objeto especificado. (Herdado de ValidationAttribute)