RangeAttribute Classe

Definição

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Origem:

RangeAttribute.cs

Especifica as restrições de intervalo numérico para o valor de um campo de dados.

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

Herança

Object

Attribute

ValidationAttribute

RangeAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra como usar o RangeAttribute para personalizar a formatação de um campo de dados. O exemplo executa as seguintes etapas:

• Implementa uma classe parcial de metadados e a classe de metadados associada.

• Na classe de metadados associada, ela aplica o RangeAttribute atributo para obter os seguintes resultados:

  • Aplique o atributo a um campo de dados do tipo inteiro.

  • Aplique o atributo a um campo de dados inteiro e defina uma mensagem de erro de validação personalizada.

  • Aplique o atributo a um DateTime campo de dados e defina uma mensagem de erro de validação personalizada.

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

Para compilar o exemplo, você precisa do seguinte:

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

• Um site controlado por dados. Isso permite que você crie um contexto de dados para o banco de dados e a classe que contém o campo de dados a ser personalizado. Para obter mais informações, consulte Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Comentários

Ao aplicar esse atributo a um campo de dados, você deve seguir as diretrizes de como usar atributos de validação. Para obter mais informações, consulte ASP.NET Diretrizes de dados dinâmicos.

Construtores

RangeAttribute(Double, Double)	Inicializa uma nova instância da classe RangeAttribute usando os valores mínimo e máximo especificados.
RangeAttribute(Int32, Int32)	Inicializa uma nova instância da classe RangeAttribute usando os valores mínimo e máximo especificados.
RangeAttribute(Type, String, String)	Inicializa uma nova instância da classe RangeAttribute usando os valores mínimo e máximo especificados e o tipo específico.

Propriedades

ConvertValueInInvariantCulture	Obtém ou define um valor que determina se as conversões do valor que estão sendo validadas OperandType como definidas pelo type parâmetro do RangeAttribute(Type, String, String) construtor usam a cultura invariável ou a cultura atual.
ErrorMessage	Obtém ou define uma mensagem de erro para associar a um controle de validação em caso de falha da validação. (Herdado de ValidationAttribute)
ErrorMessageResourceName	Obtém ou define o nome do recurso de mensagem de erro a ser usado para pesquisar o valor da propriedade ErrorMessageResourceType se a validação falhar. (Herdado de ValidationAttribute)
ErrorMessageResourceType	Obtém ou define o tipo de recurso a ser usado para a pesquisa de mensagens de erro se a validação falhar. (Herdado de ValidationAttribute)
ErrorMessageString	Obtém a mensagem de erro de validação localizada. (Herdado de ValidationAttribute)
Maximum	Obtém o valor mínimo permitido do campo.
MaximumIsExclusive	Especifica se a validação deve falhar para valores iguais a Maximum.
Minimum	Obtém o valor mínimo do campo permitido.
MinimumIsExclusive	Especifica se a validação deve falhar para valores iguais a Minimum.
OperandType	Obtém o tipo do campo de dados cujo valor deve ser validado.
ParseLimitsInInvariantCulture	Obtém ou define um valor que determina se os valores da cadeia de caracteres para Minimum e Maximum são analisados usando a cultura invariável, em vez da cultura atual.
RequiresValidationContext	Obtém ou define um valor que indica se o atributo requer contexto de validação. (Herdado de ValidationAttribute)
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
FormatErrorMessage(String)	Formata a mensagem de erro é exibida quando há falha na validação de intervalo.
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValidationResult(Object, ValidationContext)	Verifica se o valor especificado é válido em relação ao atributo de validação atual. (Herdado de ValidationAttribute)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
IsValid(Object)	Verifica se o valor do campo de dados está no intervalo especificado.
IsValid(Object, ValidationContext)	Valida o valor especificado em relação ao atributo de validação atual. (Herdado de ValidationAttribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Validate(Object, String)	Valida o objeto especificado. (Herdado de ValidationAttribute)
Validate(Object, ValidationContext)	Valida o objeto especificado. (Herdado de ValidationAttribute)