StringLengthAttribute Classe

Définition

Espace de noms:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

StringLengthAttribute.cs

Spécifie les longueurs minimale et maximale de caractères autorisées dans un champ de données.

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

Héritage

Object

Attribute

ValidationAttribute

StringLengthAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant montre comment limiter le nombre de caractères dans un champ. Cet exemple fonctionne avec le champ ThumbnailPhotoFileName dans la table Products de la base de données AdventureWorksLT. Le champ est limité à 4 caractères en appliquant l’attribut StringLengthAttribute à la classe partielle qui représente l’entité 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  

Remarques

ASP.NET Dynamic Data active les opérations CRUD (Create, Read, Update et Delete) dans un modèle de données. Vous pouvez spécifier la longueur minimale et maximale des caractères pour chaque champ lorsque des données sont insérées ou mises à jour. Pour les types de données caractères, les MinimumLength propriétés et MaximumLength identifient le plus grand nombre d’octets requis pour stocker une chaîne.

Vous pouvez utiliser des espaces réservés de mise en forme composite dans le message d’erreur : {0} est le nom de la propriété ; {1} est la longueur maximale ; et {2} est la longueur minimale. Les espaces réservés correspondent aux arguments passés à la méthode au moment de l’exécution String.Format .

Constructeurs

StringLengthAttribute(Int32)

Initialise une nouvelle instance de la classe StringLengthAttribute en utilisant une longueur maximale spécifiée.

Propriétés

ErrorMessage	Obtient ou définit un message d'erreur à associer à un contrôle de validation si la validation échoue. (Hérité de ValidationAttribute)
ErrorMessageResourceName	Obtient ou définit le nom de la ressource de message d'erreur à utiliser pour rechercher la valeur de la propriété ErrorMessageResourceType si la validation échoue. (Hérité de ValidationAttribute)
ErrorMessageResourceType	Obtient ou définit le type de ressource à utiliser pour la recherche de message d'erreur si une validation échoue. (Hérité de ValidationAttribute)
ErrorMessageString	Obtient le message d'erreur de validation localisé. (Hérité de ValidationAttribute)
MaximumLength	Obtient ou définit la longueur maximale d'une chaîne.
MinimumLength	Obtient ou définit la longueur minimale d'une chaîne.
RequiresValidationContext	Obtient une valeur qui indique si l'attribut requiert un contexte de validation. (Hérité de ValidationAttribute)
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
FormatErrorMessage(String)	Applique une mise en forme à un message d'erreur spécifié.
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValidationResult(Object, ValidationContext)	Vérifie si la valeur spécifiée est valide en tenant compte de l'attribut de validation actuel. (Hérité de ValidationAttribute)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
IsValid(Object)	Détermine si un objet spécifié est valide.
IsValid(Object, ValidationContext)	Valide la valeur spécifiée en tenant compte de l'attribut de validation actuel. (Hérité de ValidationAttribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Validate(Object, String)	Valide l'objet spécifié. (Hérité de ValidationAttribute)
Validate(Object, ValidationContext)	Valide l'objet spécifié. (Hérité de ValidationAttribute)