RangeAttribute Класс

Определение

Пространство имен:

System.ComponentModel.DataAnnotations

Сборка:

System.ComponentModel.Annotations.dll

Исходный код:

RangeAttribute.cs

Задает ограничения числового диапазона для значения поля данных.

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

Наследование

Object

Attribute

ValidationAttribute

RangeAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере показано, как использовать RangeAttribute для настройки форматирования поля данных. В этом примере выполняются следующие действия.

• Реализует разделяемый класс метаданных и связанный класс метаданных.

• В связанном классе метаданных он применяет RangeAttribute атрибут для получения следующих результатов:

  • Примените атрибут к полю данных типа integer.

  • Примените атрибут к полю данных с целым числом и определите пользовательское сообщение об ошибке проверки.

  • Примените атрибут к полю DateTime данных и определите пользовательское сообщение об ошибке проверки.

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

Чтобы скомпилировать пример, вам потребуется следующее:

• Microsoft Visual Studio 2008 с пакетом обновления 1 (SP1) или Visual Web Developer 2008 Express Edition с пакетом обновления 1 (SP1).

• Управляемый данными веб-сайт. Это позволяет создать контекст данных для базы данных и класса, содержащего настраиваемое поле данных. Для получения дополнительной информации см. Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Комментарии

При применении этого атрибута к полю данных необходимо следовать рекомендациям по использованию атрибутов проверки. Дополнительные сведения см . в ASP.NET рекомендации по динамическим данным.

Конструкторы

RangeAttribute(Double, Double)	Инициализирует новый экземпляр RangeAttribute, используя указанное минимальное и максимально значение.
RangeAttribute(Int32, Int32)	Инициализирует новый экземпляр RangeAttribute, используя указанное минимальное и максимально значение.
RangeAttribute(Type, String, String)	Инициализирует новый экземпляр RangeAttribute, используя указанное минимальное и максимально значение, а также определенный тип.

Свойства

ConvertValueInInvariantCulture	Возвращает или задает значение, определяющее, используются ли инвариантные или текущие язык и региональные параметры при каких-либо преобразованиях значения, проверяемого OperandType в значение , заданное RangeAttribute(Type, String, String) параметром type конструктора.
ErrorMessage	Получает или задает сообщение об ошибке, которое необходимо связать с проверяющим элементом управления на случай сбоя во время проверки. (Унаследовано от ValidationAttribute)
ErrorMessageResourceName	Получает или задает имя ресурса сообщений об ошибках, используемого для поиска значения свойства ErrorMessageResourceType в случае сбоя при проверке. (Унаследовано от ValidationAttribute)
ErrorMessageResourceType	Получает или задает тип ресурса, используемого для поиска сообщения об ошибке в случае сбоя проверки. (Унаследовано от ValidationAttribute)
ErrorMessageString	Получает локализованное сообщение об ошибке проверки. (Унаследовано от ValidationAttribute)
Maximum	Получает максимальное допустимое значение поля.
MaximumIsExclusive	Указывает, должна ли проверка не выполняться для значений Maximum, равных .
Minimum	Получает минимально допустимое значение поля.
MinimumIsExclusive	Указывает, должна ли проверка не выполняться для значений Minimum, равных .
OperandType	Получает тип поля данных, значение которого нужно проверить.
ParseLimitsInInvariantCulture	Возвращает или задает значение, которое определяет, анализируются ли строковые значения Minimum и Maximum с использованием инвариантных, а не текущих языка и региональных параметров.
RequiresValidationContext	Получает значение, указывающее, требует ли атрибут контекста проверки. (Унаследовано от ValidationAttribute)
TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
FormatErrorMessage(String)	Форматирует сообщение об ошибке, отображаемое в случае сбоя при проверке диапазона.
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValidationResult(Object, ValidationContext)	Проверяет, является ли заданное значение допустимым относительно текущего атрибута проверки. (Унаследовано от ValidationAttribute)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
IsValid(Object)	Проверяет, действительно ли значение обязательного поля данных находится в указанном диапазоне.
IsValid(Object, ValidationContext)	Проверяет заданное значение относительно текущего атрибута проверки. (Унаследовано от ValidationAttribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Validate(Object, String)	Проверяет указанный объект. (Унаследовано от ValidationAttribute)
Validate(Object, ValidationContext)	Проверяет указанный объект. (Унаследовано от ValidationAttribute)