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 seguinte mostra como usar o RangeAttribute para personalizar a formatação de um campo de dados. O exemplo executa os seguintes passos:

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

  • Na classe de metadados associada, aplica-se 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.

    • Aplicar o atributo a um DateTime campo de dados e definir 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, precisa do seguinte:

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

  • Um site orientado por dados. Isto permite-lhe criar um contexto de dados para a base de dados e a classe que contém o campo de dados para personalizar. Para obter mais informações, veja Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Observações

Quando aplica este atributo a um campo de dados, deve seguir as orientações sobre como usar atributos de validação. Para mais informações, consulte ASP.NET Diretrizes de Dados Dinâmicos.

Construtores

Name 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ínimos e máximos especificados e o tipo específico.

Propriedades

Name Description
ErrorMessage

Recebe ou define uma mensagem de erro para associar a um controlo de validação se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageResourceName

Recebe ou define o nome do recurso da mensagem de erro para ser usado para consultar o valor da ErrorMessageResourceType propriedade caso a validação falhe.

(Herdado de ValidationAttribute)
ErrorMessageResourceType

Obtém ou define o tipo de recurso a usar para a consulta de mensagens de erro caso a validação falhe.

(Herdado de ValidationAttribute)
ErrorMessageString

Recebe a mensagem de erro de validação localizada.

(Herdado de ValidationAttribute)
Maximum

Obtém o valor máximo permitido do campo.

Minimum

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

OperandType

Obtém o tipo do campo de dados cujo valor deve ser validado.

RequiresValidationContext

Obtém um valor que indica se o atributo requer contexto de validação.

(Herdado de ValidationAttribute)
TypeId

Quando implementado numa classe derivada, obtém um identificador único para esta Attribute.

(Herdado de Attribute)

Métodos

Name Description
Equals(Object)

Devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
FormatErrorMessage(String)

Formata a mensagem de erro que é exibida quando a validação de intervalo falha.

GetHashCode()

Devolve o código de hash para esta 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 relativamente ao atributo de validação atual.

(Herdado de ValidationAttribute)
IsDefaultAttribute()

Quando sobrescrito numa classe derivada, indica se o valor desta 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á dentro do intervalo especificado.

Match(Object)

Quando sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia 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)

Implementações de Interface Explícita

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

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho.

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

Recupera a informação de tipo de um objeto, que pode ser usada para obter a informação de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

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

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

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

(Herdado de Attribute)

Aplica-se a