RangeAttribute Kelas

Definisi

Ruang nama:

System.ComponentModel.DataAnnotations

Rakitan:

System.ComponentModel.Annotations.dll

Sumber:

RangeAttribute.cs

Menentukan batasan rentang numerik untuk nilai bidang data.

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

Warisan

Object

Attribute

ValidationAttribute

RangeAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut ini memperlihatkan cara menggunakan RangeAttribute untuk mengkustomisasi pemformatan untuk bidang data. Contohnya melakukan langkah-langkah berikut:

• Menerapkan kelas parsial metadata dan kelas metadata terkait.

• Di kelas metadata terkait, ia menerapkan RangeAttribute atribut untuk mendapatkan hasil berikut:

  • Terapkan atribut ke bidang data dari bilangan bulat jenis.

  • Terapkan atribut ke bidang data bilangan bulat dan tentukan pesan kesalahan validasi kustom.

  • Terapkan atribut ke DateTime bidang data dan tentukan pesan kesalahan validasi kustom.

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

Untuk mengkompilasi contoh, Anda memerlukan hal berikut:

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

• Situs Web berbasis data. Ini memungkinkan Anda membuat konteks data untuk database dan kelas yang berisi bidang data untuk dikustomisasi. Untuk informasi selengkapnya, lihat Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Keterangan

Saat Menerapkan atribut ini ke bidang data, Anda harus mengikuti panduan cara menggunakan atribut validasi. Untuk informasi selengkapnya, lihat ASP.NET Panduan Data Dinamis.

Konstruktor

RangeAttribute(Double, Double)	Menginisialisasi instans RangeAttribute baru kelas dengan menggunakan nilai minimum dan maksimum yang ditentukan.
RangeAttribute(Int32, Int32)	Menginisialisasi instans RangeAttribute baru kelas dengan menggunakan nilai minimum dan maksimum yang ditentukan.
RangeAttribute(Type, String, String)	Menginisialisasi instans RangeAttribute baru kelas dengan menggunakan nilai minimum dan maksimum yang ditentukan dan jenis tertentu.

Properti

ConvertValueInInvariantCulture	Mendapatkan atau menetapkan nilai yang menentukan apakah ada konversi nilai yang divalidasi OperandType sebagaimana ditetapkan oleh type parameter RangeAttribute(Type, String, String) konstruktor menggunakan budaya invarian atau budaya saat ini.
ErrorMessage	Mendapatkan atau mengatur pesan kesalahan untuk dikaitkan dengan kontrol validasi jika validasi gagal. (Diperoleh dari ValidationAttribute)
ErrorMessageResourceName	Mendapatkan atau mengatur nama sumber daya pesan kesalahan yang akan digunakan untuk mencari ErrorMessageResourceType nilai properti jika validasi gagal. (Diperoleh dari ValidationAttribute)
ErrorMessageResourceType	Mendapatkan atau mengatur jenis sumber daya yang akan digunakan untuk pencarian pesan kesalahan jika validasi gagal. (Diperoleh dari ValidationAttribute)
ErrorMessageString	Mendapatkan pesan kesalahan validasi yang dilokalkan. (Diperoleh dari ValidationAttribute)
Maximum	Mendapatkan nilai bidang maksimum yang diizinkan.
MaximumIsExclusive	Menentukan apakah validasi harus gagal untuk nilai yang sama dengan Maximum.
Minimum	Mendapatkan nilai bidang minimum yang diizinkan.
MinimumIsExclusive	Menentukan apakah validasi harus gagal untuk nilai yang sama dengan Minimum.
OperandType	Mendapatkan jenis bidang data yang nilainya harus divalidasi.
ParseLimitsInInvariantCulture	Mendapatkan atau menetapkan nilai yang menentukan apakah nilai string untuk Minimum dan Maximum diurai menggunakan budaya invarian daripada budaya saat ini.
RequiresValidationContext	Mendapatkan nilai yang menunjukkan apakah atribut memerlukan konteks validasi. (Diperoleh dari ValidationAttribute)
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
FormatErrorMessage(String)	Memformat pesan kesalahan yang ditampilkan saat validasi rentang gagal.
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetValidationResult(Object, ValidationContext)	Memeriksa apakah nilai yang ditentukan valid sehubungan dengan atribut validasi saat ini. (Diperoleh dari ValidationAttribute)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
IsValid(Object)	Memeriksa apakah nilai bidang data berada dalam rentang yang ditentukan.
IsValid(Object, ValidationContext)	Memvalidasi nilai yang ditentukan sehubungan dengan atribut validasi saat ini. (Diperoleh dari ValidationAttribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Validate(Object, String)	Memvalidasi objek yang ditentukan. (Diperoleh dari ValidationAttribute)
Validate(Object, ValidationContext)	Memvalidasi objek yang ditentukan. (Diperoleh dari ValidationAttribute)