RangeAttribute Sınıf

Tanım

Veri alanının değeri için sayısal aralık kısıtlamalarını belirtir.

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
Devralma
Öznitelikler

Örnekler

Aşağıdaki örnekte, bir veri alanının biçimlendirmesini RangeAttribute özelleştirmek için öğesinin nasıl kullanılacağı gösterilmektedir. Örnek aşağıdaki adımları gerçekleştirir:

  • Bir meta veri kısmi sınıfını ve ilişkili meta veri sınıfını uygular.

  • İlişkili meta veri sınıfında özniteliğini RangeAttribute uygulayarak aşağıdaki sonuçları elde eder:

    • özniteliğini tamsayı türünde bir veri alanına uygulayın.

    • Özniteliği bir tamsayı veri alanına uygulayın ve özel bir doğrulama hata iletisi tanımlayın.

    • Özniteliği bir DateTime veri alanına uygulayın ve özel bir doğrulama hata iletisi tanımlayın.

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

Örneği derlemek için aşağıdakiler gerekir:

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

  • Veri temelli bir Web sitesi. Bu, veritabanı ve özelleştirebileceğiniz veri alanını içeren sınıf için bir veri bağlamı oluşturmanıza olanak tanır. Daha fazla bilgi için bkz. Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Açıklamalar

Bu özniteliği bir veri alanına uyguladığınızda doğrulama özniteliklerini kullanma yönergelerini izlemeniz gerekir. Daha fazla bilgi için bkz. ASP.NET Dinamik Veri Yönergeleri.

Oluşturucular

RangeAttribute(Double, Double)

Belirtilen en düşük ve en yüksek değerleri kullanarak sınıfının yeni bir örneğini RangeAttribute başlatır.

RangeAttribute(Int32, Int32)

Belirtilen en düşük ve en yüksek değerleri kullanarak sınıfının yeni bir örneğini RangeAttribute başlatır.

RangeAttribute(Type, String, String)

Belirtilen en düşük ve en yüksek değerleri ve belirli bir türü kullanarak sınıfının yeni bir örneğini RangeAttribute başlatır.

Özellikler

ConvertValueInInvariantCulture

Oluşturucunun parametresi tarafından type ayarlandığı şekilde doğrulanan OperandType değerin herhangi bir dönüştürmesinin RangeAttribute(Type, String, String) sabit kültürü mü yoksa geçerli kültürü mü kullandığını belirleyen bir değeri alır veya ayarlar.

ErrorMessage

Doğrulama başarısız olursa bir doğrulama denetimiyle ilişkilendirilecek bir hata iletisi alır veya ayarlar.

(Devralındığı yer: ValidationAttribute)
ErrorMessageResourceName

Doğrulama başarısız olursa özellik değerini aramak ErrorMessageResourceType için kullanılacak hata iletisi kaynak adını alır veya ayarlar.

(Devralındığı yer: ValidationAttribute)
ErrorMessageResourceType

Doğrulama başarısız olursa hata iletisi araması için kullanılacak kaynak türünü alır veya ayarlar.

(Devralındığı yer: ValidationAttribute)
ErrorMessageString

Yerelleştirilmiş doğrulama hata iletisini alır.

(Devralındığı yer: ValidationAttribute)
Maximum

İzin verilen en büyük alan değerini alır.

MaximumIsExclusive

değerine eşit Maximumdeğerler için doğrulamanın başarısız olup olmayacağını belirtir.

Minimum

İzin verilen en düşük alan değerini alır.

MinimumIsExclusive

değerine eşit Minimumdeğerler için doğrulamanın başarısız olup olmayacağını belirtir.

OperandType

Değeri doğrulanması gereken veri alanının türünü alır.

ParseLimitsInInvariantCulture

ve dize değerlerinin MinimumMaximum geçerli kültür yerine sabit kültür kullanılarak ayrıştırılıp ayrıştırılmayacağını belirleyen bir değeri alır veya ayarlar.

RequiresValidationContext

Özniteliğin doğrulama bağlamı gerektip gerektirmediğini belirten bir değer alır.

(Devralındığı yer: ValidationAttribute)
TypeId

Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır.

(Devralındığı yer: Attribute)

Yöntemler

Equals(Object)

Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür.

(Devralındığı yer: Attribute)
FormatErrorMessage(String)

Aralık doğrulaması başarısız olduğunda görüntülenen hata iletisini biçimlendirin.

GetHashCode()

Bu örneğe ilişkin karma kodu döndürür.

(Devralındığı yer: Attribute)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
GetValidationResult(Object, ValidationContext)

Belirtilen değerin geçerli doğrulama özniteliğine göre geçerli olup olmadığını denetler.

(Devralındığı yer: ValidationAttribute)
IsDefaultAttribute()

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir.

(Devralındığı yer: Attribute)
IsValid(Object)

Veri alanının değerinin belirtilen aralıkta olup olmadığını denetler.

IsValid(Object, ValidationContext)

Belirtilen değeri geçerli doğrulama özniteliğine göre doğrular.

(Devralındığı yer: ValidationAttribute)
Match(Object)

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür.

(Devralındığı yer: Attribute)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
Validate(Object, String)

Belirtilen nesneyi doğrular.

(Devralındığı yer: ValidationAttribute)
Validate(Object, ValidationContext)

Belirtilen nesneyi doğrular.

(Devralındığı yer: ValidationAttribute)

Belirtik Arabirim Kullanımları

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

Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1).

(Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bir nesne tarafından sunulan özelliklere ve yöntemlere erişim sağlar.

(Devralındığı yer: Attribute)

Şunlara uygulanır