StringLengthAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel.DataAnnotations

Ensamblado:

System.ComponentModel.Annotations.dll

Source:

StringLengthAttribute.cs

Especifica la longitud mínima y máxima de caracteres que se permite en un campo de datos.

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

Herencia

Object

Attribute

ValidationAttribute

StringLengthAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo limitar el número de caracteres de un campo. En este ejemplo se trabaja con el campo ThumbnailPhotoFileName de la tabla Products de la base de datos AdventureWorksLT. El campo tiene un límite de 4 caracteres aplicando el StringLengthAttribute atributo a la clase parcial que representa la entidad 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  

Comentarios

ASP.NET Datos dinámicos habilita las operaciones CRUD (Crear, Leer, Actualizar y Eliminar) en un modelo de datos. Puede especificar la longitud mínima y máxima de caracteres para cada campo cuando se insertan o actualizan los datos. Para los tipos de datos de caracteres, las MinimumLength propiedades y MaximumLength identifican el mayor número de bytes necesarios para almacenar una cadena.

Puede usar marcadores de posición de formato compuesto en el mensaje de error: {0} es el nombre de la propiedad; {1} es la longitud máxima y {2} es la longitud mínima. Los marcadores de posición corresponden a argumentos que se pasan al String.Format método en tiempo de ejecución.

Constructores

StringLengthAttribute(Int32)

Inicializa una nueva instancia de la clase StringLengthAttribute usando una longitud máxima especificada.

Propiedades

ErrorMessage	Obtiene o establece un mensaje de error que se va a asociar a un control de validación si se produce un error de validación. (Heredado de ValidationAttribute)
ErrorMessageResourceName	Obtiene o establece el nombre de recurso del mensaje de error que se va a usar para buscar el valor de la propiedad ErrorMessageResourceType si se produce un error en la validación. (Heredado de ValidationAttribute)
ErrorMessageResourceType	Obtiene o establece el tipo de recurso que se va a usar para buscar el mensaje de error si se produce un error de validación. (Heredado de ValidationAttribute)
ErrorMessageString	Obtiene el mensaje de error de validación traducido. (Heredado de ValidationAttribute)
MaximumLength	Obtiene o establece la longitud máxima de una cadena.
MinimumLength	Obtiene o establece la longitud mínima de una cadena.
RequiresValidationContext	Obtiene un valor que indica si el atributo requiere contexto de validación. (Heredado de ValidationAttribute)
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
FormatErrorMessage(String)	Aplica formato a un mensaje de error especificado.
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValidationResult(Object, ValidationContext)	Comprueba si el valor especificado es válido con respecto al atributo de validación actual. (Heredado de ValidationAttribute)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
IsValid(Object)	Determina si un objeto especificado es válido.
IsValid(Object, ValidationContext)	Valida el valor especificado con respecto al atributo de validación actual. (Heredado de ValidationAttribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Validate(Object, String)	Valida el objeto especificado. (Heredado de ValidationAttribute)
Validate(Object, ValidationContext)	Valida el objeto especificado. (Heredado de ValidationAttribute)