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 a RangeAttribute formatação para personalizar 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.

Construtores

Nome Description
RangeAttribute(Double, Double)

Inicializa uma nova instância da RangeAttribute classe usando os valores mínimos e máximos especificados.

RangeAttribute(Int32, Int32)

Inicializa uma nova instância da RangeAttribute classe usando os valores mínimos e máximos especificados.

RangeAttribute(Type, String, String)

Inicializa uma nova instância da RangeAttribute classe usando os valores mínimo e máximo especificados e o tipo específico.

Propriedades

Nome Description
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 a ser associada a um controle de validação se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageResourceName

Obtém ou define o nome do recurso de mensagem de erro a ser usado para pesquisar o valor da ErrorMessageResourceType propriedade se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageResourceType

Obtém ou define o tipo de recurso a ser usado para pesquisa de mensagem 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áximo permitido do campo.

MaximumIsExclusive

Especifica se a validação deve falhar para valores iguais a Maximum.

Minimum

Obtém o valor mínimo permitido do campo.

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 de cadeia de caracteres são MinimumMaximum analisados usando a cultura invariável em vez da cultura atual.

RequiresValidationContext

Obtém 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 esse Attribute.

(Herdado de Attribute)

Métodos

Nome Description
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 a validação de intervalo falha.

GetHashCode()

Retorna o código hash dessa 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, ValidationContext)

Valida o valor especificado em relação ao atributo de validação atual.

(Herdado de ValidationAttribute)
IsValid(Object)

Verifica se o valor do campo de dados está no intervalo especificado.

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 Objectatual.

(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

Nome Description
_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 de um objeto, que podem ser usadas para obter as informações de tipo de 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