StringLengthAttribute Classe

Definição

Especifica o comprimento mínimo e máximo dos caracteres permitidos num 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.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
Herança
StringLengthAttribute
Atributos

Exemplos

O exemplo seguinte mostra como limitar o número de caracteres num campo. Este exemplo funciona com o campo ThumbnailPhotoFileName na tabela Products da base de dados AdventureWorksLT. O campo está limitado a 4 caracteres aplicando o StringLengthAttribute atributo à classe parcial que representa a entidade Produto.

[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

Observações

O ASP.NET Dynamic Data permite operações CRUD (Crear, Ler, Atualizar e Eliminar) num modelo de dados. Pode especificar o comprimento mínimo e máximo dos caracteres para cada campo quando os dados estão a ser 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.

Pode usar marcadores de papel composto na mensagem de erro: {0} é o nome da propriedade; {1} é o comprimento máximo; e {2} é o comprimento mínimo. Os marcadores correspondem a argumentos que são passados ao String.Format método em tempo de execução.

Construtores

Name Description
StringLengthAttribute(Int32)

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

Propriedades

Name Description
ErrorMessage

Recebe ou define uma mensagem de erro para associar a um controlo de validação se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageResourceName

Recebe ou define o nome do recurso da mensagem de erro para ser usado para consultar o valor da ErrorMessageResourceType propriedade caso a validação falhe.

(Herdado de ValidationAttribute)
ErrorMessageResourceType

Obtém ou define o tipo de recurso a usar para a consulta de mensagens de erro caso a validação falhe.

(Herdado de ValidationAttribute)
ErrorMessageString

Recebe a mensagem de erro de validação localizada.

(Herdado de ValidationAttribute)
MaximumLength

Obtém ou define o comprimento máximo de uma corda.

MinimumLength

Obtém ou define o comprimento mínimo de uma corda.

RequiresValidationContext

Obtém um valor que indica se o atributo requer contexto de validação.

(Herdado de ValidationAttribute)
TypeId

Quando implementado numa classe derivada, obtém um identificador único para esta Attribute.

(Herdado de Attribute)

Métodos

Name Description
Equals(Object)

Devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
FormatErrorMessage(String)

Aplica formatação a uma mensagem de erro especificada.

GetHashCode()

Devolve o código de hash para esta 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 relativamente ao atributo de validação atual.

(Herdado de ValidationAttribute)
IsDefaultAttribute()

Quando sobrescrito numa classe derivada, indica se o valor desta 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 sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia 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)

Implementações de Interface Explícita

Name Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera a informação de tipo de um objeto, que pode ser usada para obter a informação de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera o número de interfaces de informações de tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a