RangeAttribute Classe

Definição

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.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
Herança
Atributos

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)

Implantações explícitas de interface

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

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornece acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a