RangeAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

RangeAttribute.cs

Specifica i vincoli dell'intervallo numerico per il valore di un campo dati.

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

Ereditarietà

Object

Attribute

ValidationAttribute

RangeAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene illustrato come usare per personalizzare la RangeAttribute formattazione per un campo dati. L'esempio esegue i passaggi seguenti:

• Implementa una classe parziale dei metadati e la classe di metadati associata.

• Nella classe di metadati associata viene applicato l'attributo RangeAttribute per ottenere i risultati seguenti:

  • Applicare l'attributo a un campo dati di tipo integer.

  • Applicare l'attributo a un campo dati integer e definire un messaggio di errore di convalida personalizzato.

  • Applicare l'attributo a un DateTime campo dati e definire un messaggio di errore di convalida personalizzato.

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

Per compilare l'esempio, è necessario quanto segue:

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

• Sito Web basato sui dati. In questo modo è possibile creare un contesto dati per il database e la classe che contiene il campo dati da personalizzare. Per altre informazioni, vedere Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Commenti

Quando si applica questo attributo a un campo dati, è necessario seguire le linee guida per l'uso degli attributi di convalida. Per altre informazioni, vedere ASP.NET Linee guida per i dati dinamici.

Costruttori

RangeAttribute(Double, Double)	Inizializza una nuova istanza della classe RangeAttribute utilizzando i valori minimo e massimo specificati.
RangeAttribute(Int32, Int32)	Inizializza una nuova istanza della classe RangeAttribute utilizzando i valori minimo e massimo specificati.
RangeAttribute(Type, String, String)	Inizializza una nuova istanza della classe RangeAttribute utilizzando i valori minimo e massimo specificati, oltre al tipo specificato.

Proprietà

ConvertValueInInvariantCulture	Ottiene o imposta un valore che determina se le conversioni del valore da convalidare a OperandType come impostate dal type parametro del RangeAttribute(Type, String, String) costruttore utilizzano le impostazioni cultura invarianti o le impostazioni cultura correnti.
ErrorMessage	Ottiene o imposta un messaggio di errore da associare a un controllo di convalida se la convalida non riesce. (Ereditato da ValidationAttribute)
ErrorMessageResourceName	Ottiene o imposta il nome di risorsa del messaggio di errore da utilizzare per la ricerca del valore della proprietà ErrorMessageResourceType se la convalida non riesce. (Ereditato da ValidationAttribute)
ErrorMessageResourceType	Ottiene o imposta il tipo di risorsa da utilizzare per la ricerca del messaggio di errore se la convalida non riesce. (Ereditato da ValidationAttribute)
ErrorMessageString	Ottiene il messaggio di errore di convalida localizzato. (Ereditato da ValidationAttribute)
Maximum	Ottiene il valore massimo consentito per il campo.
MaximumIsExclusive	Specifica se la convalida deve avere esito negativo per i valori uguali a Maximum.
Minimum	Ottiene il valore minimo consentito per il campo.
MinimumIsExclusive	Specifica se la convalida deve avere esito negativo per i valori uguali a Minimum.
OperandType	Ottiene il tipo del campo dati il cui valore deve essere convalidato.
ParseLimitsInInvariantCulture	Ottiene o imposta un valore che determina se i valori di stringa per Minimum e Maximum vengono analizzati usando le impostazioni cultura inglese non dipendenti da paese/area geografica anziché le impostazioni cultura correnti.
RequiresValidationContext	Ottiene un valore che indica se l'attributo richiede il contesto di convalida. (Ereditato da ValidationAttribute)
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
FormatErrorMessage(String)	Formatta il messaggio di errore visualizzato quando la convalida dell'intervallo non riesce.
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValidationResult(Object, ValidationContext)	Verifica se il valore specificato è valido rispetto all'attributo di convalida corrente. (Ereditato da ValidationAttribute)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
IsValid(Object)	Verifica che il valore del campo dati rientri nell'intervallo specificato.
IsValid(Object, ValidationContext)	Convalida il valore specificato rispetto all'attributo di convalida corrente. (Ereditato da ValidationAttribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Validate(Object, String)	Convalida l'oggetto specificato. (Ereditato da ValidationAttribute)
Validate(Object, ValidationContext)	Convalida l'oggetto specificato. (Ereditato da ValidationAttribute)