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.

• V přidružené třídě metadat použije atribut k RangeAttribute 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

Ke 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 vám umožní vytvořit kontext dat pro databázi a třídu, která obsahuje datové pole, které chcete přizpůsobit. Další informace naleznete v tématu Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Poznámky

Při použití tohoto atributu u datového pole musíte postupovat podle pokynů pro použití ověřovacích atributů. Další informace najdete v tématu ASP.NET pokyny pro dynamická data.

Konstruktory

RangeAttribute(Double, Double)	Inicializuje novou instanci RangeAttribute třídy pomocí zadaných minimálních a maximálních hodnot.
RangeAttribute(Int32, Int32)	Inicializuje novou instanci RangeAttribute třídy pomocí zadaných minimálních a maximálních hodnot.
RangeAttribute(Type, String, String)	Inicializuje novou instanci RangeAttribute třídy pomocí zadaných minimálních a maximálních hodnot a konkrétního typu.

Vlastnosti

ConvertValueInInvariantCulture	Získá nebo nastaví hodnotu, která určuje, zda jakékoli převody ověřované hodnoty jako OperandType nastaven parametr konstruktoru typeRangeAttribute(Type, String, String) 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 ověření selže. (Zděděno od ValidationAttribute)
ErrorMessageResourceName	Získá nebo nastaví název prostředku chybové zprávy, který se použije k vyhledání ErrorMessageResourceType hodnoty vlastnosti, pokud ověření selže. (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, jestli se má ověření nezdařit pro hodnoty, které se rovnají Maximum.
Minimum	Získá minimální povolenou hodnotu pole.
MinimumIsExclusive	Určuje, jestli se má ověření nezdařit pro hodnoty, které se rovnají 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 tuto Attributetřídu . (Zděděno od Attribute)

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
FormatErrorMessage(String)	Formátuje chybovou zprávu, která se zobrazí, když se ověření rozsahu nezdaří.
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Type Získá z 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ě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
IsValid(Object)	Zkontroluje, jestli je hodnota datového pole v zadaném rozsahu.
IsValid(Object, ValidationContext)	Ověří zadanou hodnotu s ohledem na aktuální ověřovací atribut. (Zděděno od ValidationAttribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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)