RangeAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel.DataAnnotations

Ensamblado:

System.ComponentModel.Annotations.dll

Source:

RangeAttribute.cs

Especifica las restricciones de intervalo numérico para el valor de un campo de datos.

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.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RangeAttribute = class
    inherit ValidationAttribute

Public Class RangeAttribute
Inherits ValidationAttribute

Herencia

Object

Attribute

ValidationAttribute

RangeAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo usar para personalizar el RangeAttribute formato de un campo de datos. En el ejemplo se realizan los pasos siguientes:

• Implementa una clase parcial de metadatos y la clase de metadatos asociada.

• En la clase de metadatos asociada, aplica el RangeAttribute atributo para obtener los siguientes resultados:

  • Aplique el atributo a un campo de datos de tipo entero.

  • Aplique el atributo a un campo de datos enteros y defina un mensaje de error de validación personalizado.

  • Aplique el atributo a un DateTime campo de datos y defina un mensaje de error de validación personalizado.

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 el ejemplo, necesita lo siguiente:

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

• Un sitio web controlado por datos. Esto le permite crear un contexto de datos para la base de datos y la clase que contiene el campo de datos que se va a personalizar. Para obtener más información, vea Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Comentarios

Al aplicar este atributo a un campo de datos, debe seguir las instrucciones para usar atributos de validación. Para obtener más información, consulte ASP.NET Directrices de datos dinámicos.

Constructores

RangeAttribute(Double, Double)	Inicializa una nueva instancia de la clase RangeAttribute usando los valores mínimo y máximo especificados.
RangeAttribute(Int32, Int32)	Inicializa una nueva instancia de la clase RangeAttribute usando los valores mínimo y máximo especificados.
RangeAttribute(Type, String, String)	Inicializa una nueva instancia de la clase RangeAttribute usando los valores mínimo y máximo especificados y el tipo especificado.

Propiedades

ConvertValueInInvariantCulture	Obtiene o establece un valor que determina si las conversiones del valor que se validan OperandType en según el type parámetro del RangeAttribute(Type, String, String) constructor usan la referencia cultural invariable o la referencia cultural actual.
ErrorMessage	Obtiene o establece un mensaje de error que se va a asociar a un control de validación si se produce un error de validación. (Heredado de ValidationAttribute)
ErrorMessageResourceName	Obtiene o establece el nombre de recurso del mensaje de error que se va a usar para buscar el valor de la propiedad ErrorMessageResourceType si se produce un error en la validación. (Heredado de ValidationAttribute)
ErrorMessageResourceType	Obtiene o establece el tipo de recurso que se va a usar para buscar el mensaje de error si se produce un error de validación. (Heredado de ValidationAttribute)
ErrorMessageString	Obtiene el mensaje de error de validación traducido. (Heredado de ValidationAttribute)
Maximum	Obtiene valor máximo permitido para el campo.
MaximumIsExclusive	Especifica si se debe producir un error en la validación de los valores que son iguales a Maximum.
Minimum	Obtiene el valor mínimo permitido para el campo.
MinimumIsExclusive	Especifica si se debe producir un error en la validación de los valores que son iguales a Minimum.
OperandType	Obtiene el tipo del campo de datos cuyo valor debe validarse.
ParseLimitsInInvariantCulture	Obtiene o establece un valor que determina si los valores de cadena para Minimum y Maximum se analizan mediante la referencia cultural invariable, en lugar de la referencia cultural actual.
RequiresValidationContext	Obtiene un valor que indica si el atributo requiere contexto de validación. (Heredado de ValidationAttribute)
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
FormatErrorMessage(String)	Da formato al mensaje de error que se muestra cuando se produce un error de validación de intervalo.
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValidationResult(Object, ValidationContext)	Comprueba si el valor especificado es válido con respecto al atributo de validación actual. (Heredado de ValidationAttribute)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
IsValid(Object)	Comprueba si el valor del campo de datos se encuentra dentro del intervalo especificado.
IsValid(Object, ValidationContext)	Valida el valor especificado con respecto al atributo de validación actual. (Heredado de ValidationAttribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Validate(Object, String)	Valida el objeto especificado. (Heredado de ValidationAttribute)
Validate(Object, ValidationContext)	Valida el objeto especificado. (Heredado de ValidationAttribute)