RangeAttribute Třída

Definice

Obor názvů:

System.ComponentModel.DataAnnotations

Sestavení:

System.ComponentModel.Annotations.dll

Zdroj:

RangeAttribute.cs

Určuje omezení číselného rozsahu pro hodnotu datového pole.

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

Dědičnost

Object

Attribute

ValidationAttribute

RangeAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad ukazuje, jak použít RangeAttribute k přizpůsobení formátování datového pole. Příklad provede následující kroky:

• Implementuje částečnou třídu metadat a přidruženou třídu metadat.

• Ve třídě přidružených metadat použije RangeAttribute atribut k získání následujících výsledků:

  • Použijte atribut na datové pole typu integer.

  • Použijte atribut na celočíselné datové pole a definujte vlastní chybovou zprávu ověření.

  • Použijte atribut na DateTime datové pole a definujte vlastní chybovou zprávu ověření.

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

K kompilaci příkladu potřebujete následující:

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

• Web řízený daty To umožňuje vytvořit kontext dat pro databázi a třídu, která obsahuje datové pole pro přizpůsobení. Další informace najdete na webu Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Poznámky

Pokud tento atribut použijete u datového pole, musíte postupovat podle pokynů pro použití ověřovacích atributů.

Konstruktory

Name	Description
RangeAttribute(Double, Double)	Inicializuje novou instanci RangeAttribute třídy pomocí zadané minimální a maximální hodnoty.
RangeAttribute(Int32, Int32)	Inicializuje novou instanci RangeAttribute třídy pomocí zadané minimální a maximální hodnoty.
RangeAttribute(Type, String, String)	Inicializuje novou instanci RangeAttribute třídy pomocí zadané minimální a maximální hodnoty a konkrétní typ.

Vlastnosti

Name	Description
ConvertValueInInvariantCulture	Získá nebo nastaví hodnotu, která určuje, zda jakékoli převody hodnoty, které jsou ověřeny jako OperandType nastaveny parametrem typeRangeAttribute(Type, String, String) konstruktoru použít invariantní jazykovou verzi nebo aktuální jazykovou verzi.
ErrorMessage	Získá nebo nastaví chybovou zprávu, která se přidruží k ověřovacímu ovládacímu prvku, pokud se ověření nezdaří. (Zděděno od ValidationAttribute)
ErrorMessageResourceName	Získá nebo nastaví název prostředku chybové zprávy použít k vyhledání ErrorMessageResourceType hodnoty vlastnosti v případě selhání ověření. (Zděděno od ValidationAttribute)
ErrorMessageResourceType	Získá nebo nastaví typ prostředku, který se má použít pro vyhledávání chybových zpráv, pokud se ověření nezdaří. (Zděděno od ValidationAttribute)
ErrorMessageString	Získá lokalizovanou ověřovací chybovou zprávu. (Zděděno od ValidationAttribute)
Maximum	Získá maximální povolenou hodnotu pole.
MaximumIsExclusive	Určuje, zda má ověření selhat pro hodnoty, které jsou rovny Maximum.
Minimum	Získá minimální povolenou hodnotu pole.
MinimumIsExclusive	Určuje, zda má ověření selhat pro hodnoty, které jsou rovny Minimum.
OperandType	Získá typ datového pole, jehož hodnota musí být ověřena.
ParseLimitsInInvariantCulture	Získá nebo nastaví hodnotu, která určuje, zda řetězcové hodnoty pro Minimum a Maximum jsou analyzovány pomocí invariantní jazykové verze namísto aktuální jazykové verze.
RequiresValidationContext	Získá hodnotu, která označuje, zda atribut vyžaduje kontext ověření. (Zděděno od ValidationAttribute)
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
FormatErrorMessage(String)	Naformátuje chybovou zprávu, která se zobrazí při selhání ověření rozsahu.
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetValidationResult(Object, ValidationContext)	Zkontroluje, zda je zadaná hodnota platná s ohledem na aktuální ověřovací atribut. (Zděděno od ValidationAttribute)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
IsValid(Object, ValidationContext)	Ověří zadanou hodnotu s ohledem na aktuální ověřovací atribut. (Zděděno od ValidationAttribute)
IsValid(Object)	Zkontroluje, jestli je hodnota datového pole v zadaném rozsahu.
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Validate(Object, String)	Ověří zadaný objekt. (Zděděno od ValidationAttribute)
Validate(Object, ValidationContext)	Ověří zadaný objekt. (Zděděno od ValidationAttribute)