RangeAttribute Classe

Definição

Especifica as restrições de intervalo numérico para o valor de um campo de dados.Specifies the numeric range constraints for the value of a data field.

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
public class RangeAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class RangeAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
type RangeAttribute = class
    inherit ValidationAttribute
Public Class RangeAttribute
Inherits ValidationAttribute
Herança
Atributos

Exemplos

O exemplo a seguir mostra como usar a RangeAttribute para personalizar a formatação de um campo de dados.The following example shows how to use the RangeAttribute to customize formatting for a data field. O exemplo executa as seguintes etapas:The example performs the following steps:

  • Implementa uma classe parcial de metadados e a classe de metadados associada.Implements a metadata partial class and the associated metadata class.

  • Na classe de metadados associada, ele aplica o atributo RangeAttribute para obter os seguintes resultados:In the associated metadata class, it applies the RangeAttribute attribute to obtain the following results:

    • Aplique o atributo a um campo de dados do tipo inteiro.Apply the attribute to a data field of type integer.

    • Aplique o atributo a um campo de dados inteiro e defina uma mensagem de erro de validação personalizada.Apply the attribute to an integer data field and define a custom validation error message.

    • Aplique o atributo a um campo de dados DateTime e defina uma mensagem de erro de validação personalizada.Apply the attribute to a DateTime data field and define a custom validation error message.

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:To compile the example, you need the following:

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

  • Um site controlado por dados.A data-driven Web site. Isso permite que você crie um contexto de dados para o Database e a classe que contém o campo de dados a ser personalizado.This enables you to create a data context for the database and the class that contains the data field to customize. Para obter mais informações, consulte Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.For more information, see 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.When you apply this attribute to a data field, you must follow the guidelines for how to use validation attributes. Para obter mais informações, consulte ASP.NET dados dinâmicos diretrizes.For more information, see ASP.NET Dynamic Data Guidelines.

Construtores

RangeAttribute(Double, Double)

Inicializa uma nova instância da classe RangeAttribute usando os valores mínimo e máximo especificados.Initializes a new instance of the RangeAttribute class by using the specified minimum and maximum values.

RangeAttribute(Int32, Int32)

Inicializa uma nova instância da classe RangeAttribute usando os valores mínimo e máximo especificados.Initializes a new instance of the RangeAttribute class by using the specified minimum and maximum values.

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.Initializes a new instance of the RangeAttribute class by using the specified minimum and maximum values and the specific type.

Propriedades

ConvertValueInInvariantCulture

Obtém ou define um valor que determina se as conversões do valor que está sendo validado para OperandType conforme definido pelo parâmetro type do construtor RangeAttribute(Type, String, String) usam a cultura invariável ou a cultura atual.Gets or sets a value that determines whether any conversions of the value being validated to OperandType as set by the type parameter of the RangeAttribute(Type, String, String) constructor use the invariant culture or the current culture.

ErrorMessage

Obtém ou define uma mensagem de erro para associar a um controle de validação em caso de falha da validação.Gets or sets an error message to associate with a validation control if validation fails.

(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.Gets or sets the error message resource name to use in order to look up the ErrorMessageResourceType property value if validation fails.

(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.Gets or sets the resource type to use for error-message lookup if validation fails.

(Herdado de ValidationAttribute)
ErrorMessageString

Obtém a mensagem de erro de validação localizada.Gets the localized validation error message.

(Herdado de ValidationAttribute)
Maximum

Obtém o valor mínimo permitido do campo.Gets the maximum allowed field value.

Minimum

Obtém o valor mínimo do campo permitido.Gets the minimum allowed field value.

OperandType

Obtém o tipo do campo de dados cujo valor deve ser validado.Gets the type of the data field whose value must be validated.

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.Gets or sets a value that determines whether string values for Minimum and Maximum are parsed using the invariant culture rather than the current culture.

RequiresValidationContext

Obtém ou define um valor que indica se o atributo requer contexto de validação.Gets a value that indicates whether the attribute requires validation context.

(Herdado de ValidationAttribute)
TypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Herdado de Attribute)

Métodos

Equals(Object)

Retorna um valor que indica se essa instância é igual a um objeto especificado.Returns a value that indicates whether this instance is equal to a specified object.

(Herdado de Attribute)
FormatErrorMessage(String)

Formata a mensagem de erro é exibida quando há falha na validação de intervalo.Formats the error message that is displayed when range validation fails.

GetHashCode()

Retorna o código hash para a instância.Returns the hash code for this instance.

(Herdado de Attribute)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValidationResult(Object, ValidationContext)

Verifica se o valor especificado é válido em relação ao atributo de validação atual.Checks whether the specified value is valid with respect to the current validation attribute.

(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.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Herdado de Attribute)
IsValid(Object)

Verifica se o valor do campo de dados está no intervalo especificado.Checks that the value of the data field is in the specified range.

IsValid(Object, ValidationContext)

Valida o valor especificado em relação ao atributo de validação atual.Validates the specified value with respect to the current validation attribute.

(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.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
Validate(Object, String)

Valida o objeto especificado.Validates the specified object.

(Herdado de ValidationAttribute)
Validate(Object, ValidationContext)

Valida o objeto especificado.Validates the specified object.

(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.Maps a set of names to a corresponding set of dispatch identifiers.

(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.Retrieves the type information for an object, which can be used to get the type information for an 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).Retrieves the number of type information interfaces that an object provides (either 0 or 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.Provides access to properties and methods exposed by an object.

(Herdado de Attribute)

Aplica-se a