StringLengthAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel.DataAnnotations

Ensamblado:

System.ComponentModel.DataAnnotations.dll

Especifica la longitud mínima y máxima de caracteres que se permiten 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. En el caso de 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

Nombre	Description
StringLengthAttribute(Int32)	Inicializa una nueva instancia de la StringLengthAttribute clase utilizando una longitud máxima especificada.

Propiedades

Nombre	Description
ErrorMessage	Obtiene o establece un mensaje de error que se va a asociar a un control de validación si se produce un error en la validación. (Heredado de ValidationAttribute)
ErrorMessageResourceName	Obtiene o establece el nombre del recurso del mensaje de error que se va a usar para buscar el valor de la propiedad si se produce un error en la ErrorMessageResourceType validación. (Heredado de ValidationAttribute)
ErrorMessageResourceType	Obtiene o establece el tipo de recurso que se va a usar para la búsqueda de mensajes de error si se produce un error en la validación. (Heredado de ValidationAttribute)
ErrorMessageString	Obtiene el mensaje de error de validación localizado. (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

Nombre	Description
Equals(Object)	Devuelve un valor que indica si esta instancia es igual a 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()	Cuando 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, ValidationContext)	Valida el valor especificado con respecto al atributo de validación actual. (Heredado de ValidationAttribute)
IsValid(Object)	Determina si un objeto especificado es válido.
Match(Object)	Cuando se reemplaza 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 Objectactual. (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)

Implementaciones de interfaz explícitas

Nombre	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera la información de tipo de un objeto, que se puede usar para obtener la información de tipo de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a propiedades y métodos expuestos por un objeto . (Heredado de Attribute)