Поделиться через


RangeAttribute Класс

Определение

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

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
Наследование
Атрибуты

Примеры

В следующем примере показано, как использовать 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)

Явные реализации интерфейса

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

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.

(Унаследовано от Attribute)

Применяется к