RangeAttribute Sınıf

Tanım

Ad Alanı:

System.ComponentModel.DataAnnotations

Bütünleştirilmiş Kod:

System.ComponentModel.Annotations.dll

Kaynak:

RangeAttribute.cs

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.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RangeAttribute = class
    inherit ValidationAttribute

Public Class RangeAttribute
Inherits ValidationAttribute

Devralma

Object

Attribute

ValidationAttribute

RangeAttribute

Öznitelikler

AttributeUsageAttribute

Ö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)