RangeAttribute 類別

定義

命名空間:

System.ComponentModel.DataAnnotations

組件:

System.ComponentModel.Annotations.dll

來源:

RangeAttribute.cs

指定資料欄位值的數值範圍條件約束。

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

繼承

Object

Attribute

ValidationAttribute

RangeAttribute

屬性

AttributeUsageAttribute

範例

下列範例示範如何使用 RangeAttribute 來自定義數據欄位的格式。 此範例會執行下列步驟：

• 實作元數據部分類別和相關聯的元數據類別。

• 在相關聯的元數據類別中，它會套用 RangeAttribute 屬性來取得下列結果：

  • 將屬性套用至整數類型的數據欄位。

  • 將屬性套用至整數數據欄位，並定義自訂驗證錯誤訊息。

  • 將屬性套用至 DateTime 數據欄位，並定義自訂驗證錯誤訊息。

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

若要編譯範例，您需要下列專案：

• Microsoft Visual Studio 2008 Service Pack 1 或 Visual Web Developer 2008 Express Edition SP1。

• 數據驅動網站。 這可讓您建立資料庫的數據內容，以及包含要自定義之數據欄位的 類別。 如需詳細資訊，請參閱Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding。

備註

當您將此屬性套用至數據欄位時，您必須遵循如何使用驗證屬性的指導方針。 如需詳細資訊，請參閱 ASP.NET 動態數據指導方針。

建構函式

RangeAttribute(Double, Double)	使用指定的最大值和最小值，初始化 RangeAttribute 類別的新執行個體。
RangeAttribute(Int32, Int32)	使用指定的最大值和最小值，初始化 RangeAttribute 類別的新執行個體。
RangeAttribute(Type, String, String)	使用指定的最大值、最小值和特定型別，初始化 RangeAttribute 類別的新執行個體。

屬性

ConvertValueInInvariantCulture	取得或設定值，這個值會決定所驗證 OperandType 值的任何轉換是否為建 type 構函式的 RangeAttribute(Type, String, String) 參數所設定，都會使用不因文化特性而異或目前的文化特性。
ErrorMessage	取得或設定錯誤訊息，此錯誤訊息會在驗證失敗時與驗證控制項產生關聯。 (繼承來源 ValidationAttribute)
ErrorMessageResourceName	取得或設定要在驗證失敗時用來查閱 ErrorMessageResourceType 屬性值的錯誤訊息資源名稱。 (繼承來源 ValidationAttribute)
ErrorMessageResourceType	取得或設定資源類型，此類型可在驗證失敗時用於查閱錯誤訊息。 (繼承來源 ValidationAttribute)
ErrorMessageString	取得當地語系化的驗證錯誤訊息。 (繼承來源 ValidationAttribute)
Maximum	取得允許的最大欄位值。
MaximumIsExclusive	指定是否應該驗證等於 Maximum的值失敗。
Minimum	取得允許的最小欄位值。
MinimumIsExclusive	指定是否應該驗證等於 Minimum的值失敗。
OperandType	取得必須驗證其值的資料欄位型別。
ParseLimitsInInvariantCulture	取得或設定值，決定是要使用不因文化特性而異，還是目前的文化特性 (Culture) 來剖析 Minimum 和 Maximum 的字串值。
RequiresValidationContext	取得值，這個值表示屬性是否需要驗證內容。 (繼承來源 ValidationAttribute)
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
FormatErrorMessage(String)	格式化在範圍驗證失敗時所顯示的錯誤訊息。
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetValidationResult(Object, ValidationContext)	檢查指定的值在目前的驗證屬性方面是否有效。 (繼承來源 ValidationAttribute)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
IsValid(Object)	檢查資料欄位的值是否在指定的範圍內。
IsValid(Object, ValidationContext)	根據目前的驗證屬性，驗證指定的值。 (繼承來源 ValidationAttribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Validate(Object, String)	驗證指定的物件。 (繼承來源 ValidationAttribute)
Validate(Object, ValidationContext)	驗證指定的物件。 (繼承來源 ValidationAttribute)