RangeAttribute Osztály

Definíció

Névtér:

System.ComponentModel.DataAnnotations

Szerelvény:

System.ComponentModel.Annotations.dll

Forrás:

RangeAttribute.cs

Megadja egy adatmező értékének numerikus tartománykorlátozásait.

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

Öröklődés

Object

Attribute

ValidationAttribute

RangeAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa bemutatja, hogyan szabhatja testre az RangeAttribute adatmezők formázását. A példa a következő lépéseket hajtja végre:

• Metaadatok részleges osztályát és a társított metaadatosztályt implementálja.

• A társított metaadatosztályban az attribútumot alkalmazza a RangeAttribute következő eredmények beszerzéséhez:

  • Alkalmazza az attribútumot egy egész szám típusú adatmezőre.

  • Alkalmazza az attribútumot egy egész szám adatmezőre, és adjon meg egy egyéni érvényesítési hibaüzenetet.

  • Alkalmazza az attribútumot egy DateTime adatmezőre, és adjon meg egy egyéni érvényesítési hibaüzenetet.

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

A példa fordításához a következőkre van szüksége:

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

• Adatvezérelt webhely. Így létrehozhat egy adatkörnyezetet az adatbázishoz és a testre szabni kívánt adatmezőt tartalmazó osztályhoz. További információért lásd Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Megjegyzések

Ha ezt az attribútumot egy adatmezőre alkalmazza, az érvényesítési attribútumok használatára vonatkozó irányelveket kell követnie. További információ: ASP.NET Dinamikus adatokra vonatkozó irányelvek.

Konstruktorok

Name	Description
RangeAttribute(Double, Double)	Inicializálja az RangeAttribute osztály új példányát a megadott minimális és maximális értékekkel.
RangeAttribute(Int32, Int32)	Inicializálja az RangeAttribute osztály új példányát a megadott minimális és maximális értékekkel.
RangeAttribute(Type, String, String)	Inicializálja az osztály új példányát a RangeAttribute megadott minimális és maximális értékek és az adott típus használatával.

Tulajdonságok

Name	Description
ConvertValueInInvariantCulture	Lekéri vagy beállítja azt az értéket, amely meghatározza, hogy a OperandType konstruktor paramétere RangeAttribute(Type, String, String) által type megadott értékre történő konverziók az invariáns kultúrát vagy az aktuális kultúrát használják-e.
ErrorMessage	Ha az ellenőrzés sikertelen, hibaüzenetet kap vagy állít be egy érvényesítési vezérlőhöz való társításhoz. (Öröklődés forrása ValidationAttribute)
ErrorMessageResourceName	Lekéri vagy beállítja a hibaüzenet erőforrásnevét a tulajdonság értékének kereséséhez, ha az ErrorMessageResourceType ellenőrzés sikertelen. (Öröklődés forrása ValidationAttribute)
ErrorMessageResourceType	Lekéri vagy beállítja az erőforrástípust a hibaüzenetek kereséséhez, ha az ellenőrzés sikertelen. (Öröklődés forrása ValidationAttribute)
ErrorMessageString	Lekéri a honosított érvényesítési hibaüzenetet. (Öröklődés forrása ValidationAttribute)
Maximum	Lekéri a maximálisan megengedett mezőértéket.
MaximumIsExclusive	Megadja, hogy az érvényesítés sikertelen legyen-e az egyenlő Maximumértékekkel.
Minimum	Lekéri a minimálisan megengedett mezőértéket.
MinimumIsExclusive	Megadja, hogy az érvényesítés sikertelen legyen-e az egyenlő Minimumértékekkel.
OperandType	Lekéri annak az adatmezőnek a típusát, amelynek értékét ellenőrizni kell.
ParseLimitsInInvariantCulture	Lekéri vagy beállít egy értéket, amely meghatározza, hogy a sztringértékek MinimumMaximum az aktuális kultúra helyett az invariáns kultúra használatával vannak-e elemezve.
RequiresValidationContext	Olyan értéket kap, amely jelzi, hogy az attribútumhoz érvényesítési környezet szükséges-e. (Öröklődés forrása ValidationAttribute)
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
FormatErrorMessage(String)	Formázja a tartományérvényesítés meghiúsulásakor megjelenő hibaüzenetet.
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetValidationResult(Object, ValidationContext)	Ellenőrzi, hogy a megadott érték érvényes-e az aktuális érvényesítési attribútumra vonatkozóan. (Öröklődés forrása ValidationAttribute)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
IsValid(Object, ValidationContext)	Ellenőrzi a megadott értéket az aktuális érvényesítési attribútummal kapcsolatban. (Öröklődés forrása ValidationAttribute)
IsValid(Object)	Ellenőrzi, hogy az adatmező értéke a megadott tartományban van-e.
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
Validate(Object, String)	Ellenőrzi a megadott objektumot. (Öröklődés forrása ValidationAttribute)
Validate(Object, ValidationContext)	Ellenőrzi a megadott objektumot. (Öröklődés forrása ValidationAttribute)