RangeAttribute Classe

Définition

Espace de noms:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

RangeAttribute.cs

Spécifie les contraintes de plage numérique pour la valeur d'un champ de données.

public ref class RangeAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class RangeAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RangeAttribute = class
    inherit ValidationAttribute

Public Class RangeAttribute
Inherits ValidationAttribute

Héritage

Object

Attribute

ValidationAttribute

RangeAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant montre comment utiliser pour personnaliser la RangeAttribute mise en forme d’un champ de données. L’exemple effectue les étapes suivantes :

• Implémente une classe partielle de métadonnées et la classe de métadonnées associée.

• Dans la classe de métadonnées associée, il applique l’attribut RangeAttribute pour obtenir les résultats suivants :

  • Appliquez l’attribut à un champ de données de type entier.

  • Appliquez l’attribut à un champ de données entier et définissez un message d’erreur de validation personnalisé.

  • Appliquez l’attribut à un DateTime champ de données et définissez un message d’erreur de validation personnalisé.

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel;

[MetadataType(typeof(ProductMetaData))]
public partial class Product
{
}

public class ProductMetaData
{
    
    [Range(10, 1000, 
        ErrorMessage = "Value for {0} must be between {1} and {2}.")]
    public object Weight;

    [Range(300, 3000)]
    public object ListPrice;

    [Range(typeof(DateTime), "1/2/2004", "3/4/2004",
        ErrorMessage = "Value for {0} must be between {1} and {2}")]
    public object SellEndDate;
}

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations
Imports System.ComponentModel

<MetadataType(GetType(ProductMetaData))> _
Partial Public Class Product

End Class


Public Class ProductMetaData
    
    <Range(10, 1000, _
           ErrorMessage:="Value for {0} must be between {1} and {2}.")> _
    Public Weight As Object

    <Range(300, 3000)> _
    Public ListPrice As Object

    <Range(GetType(DateTime), "1/2/2004", "3/4/2004", _
           ErrorMessage:="Value for {0} must be between {1} and {2}")> _
    Public SellEndDate As Object

End Class

Pour compiler l’exemple, vous avez besoin des éléments suivants :

• Microsoft Visual Studio 2008 Service Pack 1 ou Visual Web Developer 2008 Express Edition SP1.

• Site Web piloté par les données. Cela vous permet de créer un contexte de données pour la base de données et la classe qui contient le champ de données à personnaliser. Pour plus d'informations, consultez Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Remarques

Lorsque vous appliquez cet attribut à un champ de données, vous devez suivre les instructions relatives à l’utilisation des attributs de validation. Pour plus d’informations, consultez ASP.NET Instructions relatives aux données dynamiques.

Constructeurs

RangeAttribute(Double, Double)	Initialise une nouvelle instance de la classe RangeAttribute à l'aide des valeurs minimale et maximale spécifiées.
RangeAttribute(Int32, Int32)	Initialise une nouvelle instance de la classe RangeAttribute à l'aide des valeurs minimale et maximale spécifiées.
RangeAttribute(Type, String, String)	Initialise une nouvelle instance de la classe RangeAttribute à l'aide des valeurs minimale et maximale spécifiées et du type spécifié.

Propriétés

ConvertValueInInvariantCulture	Obtient ou définit une valeur qui détermine si les conversions de la valeur en OperandType cours de validation en tant que définies par le type paramètre du RangeAttribute(Type, String, String) constructeur utilisent la culture invariante ou la culture actuelle.
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)
Maximum	Obtient la valeur maximale autorisée pour le champ.
MaximumIsExclusive	Spécifie si la validation doit échouer pour les valeurs égales à Maximum.
Minimum	Obtient la valeur minimale autorisée pour le champ.
MinimumIsExclusive	Spécifie si la validation doit échouer pour les valeurs égales à Minimum.
OperandType	Obtient le type du champ de données dont la valeur doit être validée.
ParseLimitsInInvariantCulture	Obtient ou définit une valeur qui détermine si les valeurs de chaîne pour Minimum et Maximum sont analysées avec la culture invariante au lieu de la culture actuelle.
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)	Met en forme le message d'erreur affiché en cas d'échec de la validation de la plage.
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)	Vérifie que la valeur du champ de données est dans la plage spécifiée.
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)