StringLengthAttribute Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- 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) |