RangeAttribute Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
DateTimecampo 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) |