StringLengthAttribute Classe

Definição

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.DataAnnotations.dll

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 Produtos 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 estão sendo inseridos ou atualizados. Para tipos de dados de caractere, as propriedades e MaximumLength as MinimumLength propriedades 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

Nome	Description
StringLengthAttribute(Int32)	Inicializa uma nova instância da StringLengthAttribute classe usando um comprimento máximo especificado.

Propriedades

Nome	Description
ErrorMessage	Obtém ou define uma mensagem de erro a ser associada a um controle de validação se a validação falhar. (Herdado de ValidationAttribute)
ErrorMessageResourceName	Obtém ou define o nome do recurso de mensagem de erro a ser usado para pesquisar o valor da ErrorMessageResourceType propriedade se a validação falhar. (Herdado de ValidationAttribute)
ErrorMessageResourceType	Obtém ou define o tipo de recurso a ser usado para pesquisa de mensagem 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 comprimento máximo de uma cadeia de caracteres.
MinimumLength	Obtém ou define o comprimento mínimo de uma cadeia de caracteres.
RequiresValidationContext	Obtém 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 esse Attribute. (Herdado de Attribute)

Métodos

Nome	Description
Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
FormatErrorMessage(String)	Aplica a formatação a uma mensagem de erro especificada.
GetHashCode()	Retorna o código hash dessa 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, ValidationContext)	Valida o valor especificado em relação ao atributo de validação atual. (Herdado de ValidationAttribute)
IsValid(Object)	Determina se um objeto especificado é válido.
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 Objectatual. (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)

Implantações explícitas de interface

Nome	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo de um objeto, que podem ser usadas para obter as informações de tipo de uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)