Condividi tramite


RangeAttribute Classe

Definizione

Specifica i vincoli di 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 di metadati e la classe di metadati associata.

  • Nella classe di metadati associata applica 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.

Costruttori

Nome Descrizione
RangeAttribute(Double, Double)

Inizializza una nuova istanza della RangeAttribute classe utilizzando i valori minimo e massimo specificati.

RangeAttribute(Int32, Int32)

Inizializza una nuova istanza della RangeAttribute classe utilizzando i valori minimo e massimo specificati.

RangeAttribute(Type, String, String)

Inizializza una nuova istanza della RangeAttribute classe utilizzando i valori minimo e massimo specificati e il tipo specifico.

Proprietà

Nome Descrizione
ConvertValueInInvariantCulture

Ottiene o imposta un valore che determina se le conversioni del valore da convalidare in 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 della risorsa del messaggio di errore da utilizzare per cercare il valore della ErrorMessageResourceType proprietà in caso di esito negativo della convalida.

(Ereditato da ValidationAttribute)
ErrorMessageResourceType

Ottiene o imposta il tipo di risorsa da utilizzare per la ricerca di messaggi di errore in caso di esito negativo della convalida.

(Ereditato da ValidationAttribute)
ErrorMessageString

Ottiene il messaggio di errore di convalida localizzato.

(Ereditato da ValidationAttribute)
Maximum

Ottiene il valore massimo consentito del 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 stringa per Minimum e Maximum vengono analizzati utilizzando le impostazioni cultura invarianti anziché le impostazioni cultura correnti.

RequiresValidationContext

Ottiene un valore che indica se l'attributo richiede il contesto di convalida.

(Ereditato da ValidationAttribute)
TypeId

Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute.

(Ereditato da Attribute)

Metodi

Nome Descrizione
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 ha esito negativo.

GetHashCode()

Restituisce il codice hash per questa istanza.

(Ereditato da Attribute)
GetType()

Ottiene il 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()

Quando sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
IsValid(Object, ValidationContext)

Convalida il valore specificato rispetto all'attributo di convalida corrente.

(Ereditato da ValidationAttribute)
IsValid(Object)

Verifica che il valore del campo dati sia compreso nell'intervallo specificato.

Match(Object)

Quando sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(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

Nome Descrizione
_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 per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per 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 alle proprietà e ai metodi esposti da un oggetto .

(Ereditato da Attribute)

Si applica a