Sdílet prostřednictvím


RangeAttribute Třída

Definice

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.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
Dědičnost
Atributy

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)

Explicitní implementace rozhraní

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

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu objektu, které lze použít k získání informací o typu pro rozhraní.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.

(Zděděno od Attribute)

Platí pro