RangeAttribute Clase

Definición

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.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
Herencia
Atributos

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, consulte 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.

Constructores

Nombre Description
RangeAttribute(Double, Double)

Inicializa una nueva instancia de la RangeAttribute clase utilizando los valores mínimo y máximo especificados.

RangeAttribute(Int32, Int32)

Inicializa una nueva instancia de la RangeAttribute clase utilizando los valores mínimo y máximo especificados.

RangeAttribute(Type, String, String)

Inicializa una nueva instancia de la RangeAttribute clase utilizando los valores mínimo y máximo especificados y el tipo específico.

Propiedades

Nombre Description
ConvertValueInInvariantCulture

Obtiene o establece un valor que determina si alguna conversión del valor que se va a OperandType validar como establece el type parámetro del RangeAttribute(Type, String, String) constructor usa 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 en la validación.

(Heredado de ValidationAttribute)
ErrorMessageResourceName

Obtiene o establece el nombre del recurso del mensaje de error que se va a usar para buscar el valor de la propiedad si se produce un error en la ErrorMessageResourceType validación.

(Heredado de ValidationAttribute)
ErrorMessageResourceType

Obtiene o establece el tipo de recurso que se va a usar para la búsqueda de mensajes de error si se produce un error en la validación.

(Heredado de ValidationAttribute)
ErrorMessageString

Obtiene el mensaje de error de validación localizado.

(Heredado de ValidationAttribute)
Maximum

Obtiene el valor máximo permitido del 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 del 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 de 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

Nombre Description
Equals(Object)

Devuelve un valor que indica si esta instancia es igual a un objeto especificado.

(Heredado de Attribute)
FormatErrorMessage(String)

Da formato al mensaje de error que se muestra cuando se produce un error en la validación del 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()

Cuando 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, ValidationContext)

Valida el valor especificado con respecto al atributo de validación actual.

(Heredado de ValidationAttribute)
IsValid(Object)

Comprueba que el valor del campo de datos está en el intervalo especificado.

Match(Object)

Cuando se reemplaza 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 Objectactual.

(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)

Implementaciones de interfaz explícitas

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

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.

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

Recupera la información de tipo de un objeto, que se puede usar para obtener la información de tipo de una interfaz.

(Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).

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

Proporciona acceso a propiedades y métodos expuestos por un objeto .

(Heredado de Attribute)

Se aplica a