RangeAttribute Classe

Definizione

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.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
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type RangeAttribute = class
    inherit ValidationAttribute
Public Class RangeAttribute
Inherits ValidationAttribute
Ereditarietà
Attributi

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)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.

(Ereditato da Attribute)

Si applica a