RangeAttribute 類別

定義

指定資料欄位值的數值範圍條件約束。Specifies the numeric range constraints for the value of a data field.

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
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
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
繼承
屬性

範例

下列範例顯示如何使用 RangeAttribute 自訂資料欄位的格式。The following example shows how to use the RangeAttribute to customize formatting for a data field. 此範例會執行下列步驟:The example performs the following steps:

  • 會執行中繼資料部分類別和相關聯的中繼資料類別。Implements a metadata partial class and the associated metadata class.

  • 在相關聯的中繼資料類別中,它會套用 RangeAttribute 屬性來取得下列結果:In the associated metadata class, it applies the RangeAttribute attribute to obtain the following results:

    • 將屬性套用至整數類型的資料欄位。Apply the attribute to a data field of type integer.

    • 將屬性套用至整數資料欄位,並定義自訂驗證錯誤訊息。Apply the attribute to an integer data field and define a custom validation error message.

    • 將屬性套用至 DateTime 資料欄位,並定義自訂驗證錯誤訊息。Apply the attribute to a DateTime data field and define a custom validation error message.

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

若要編譯範例,您需要下列各項:To compile the example, you need the following:

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

  • 資料驅動網站。A data-driven Web site. 這可讓您建立資料庫的資料內容,以及包含要自訂之資料欄位的類別。This enables you to create a data context for the database and the class that contains the data field to customize. 如需詳細資訊,請參閱Walkthrough: Creating a New Dynamic Data Web Site using ScaffoldingFor more information, see Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

備註

當您將此屬性套用至資料欄位時,必須遵循如何使用驗證屬性的指導方針。When you apply this attribute to a data field, you must follow the guidelines for how to use validation attributes. 如需詳細資訊,請參閱 ASP.NET 動態資料指導方針For more information, see ASP.NET Dynamic Data Guidelines.

建構函式

RangeAttribute(Double, Double)

使用指定的最大值和最小值,初始化 RangeAttribute 類別的新執行個體。Initializes a new instance of the RangeAttribute class by using the specified minimum and maximum values.

RangeAttribute(Int32, Int32)

使用指定的最大值和最小值,初始化 RangeAttribute 類別的新執行個體。Initializes a new instance of the RangeAttribute class by using the specified minimum and maximum values.

RangeAttribute(Type, String, String)

使用指定的最大值、最小值和特定型別,初始化 RangeAttribute 類別的新執行個體。Initializes a new instance of the RangeAttribute class by using the specified minimum and maximum values and the specific type.

屬性

ConvertValueInInvariantCulture

取得或設定值,決定轉換要向 RangeAttribute(Type, String, String) 建構函式 type 參數所設定 OperandType 進行驗證的值時,要使用不因文化特性而異,還是目前的文化特性 (Culture)。Gets or sets a value that determines whether any conversions of the value being validated to OperandType as set by the type parameter of the RangeAttribute(Type, String, String) constructor use the invariant culture or the current culture.

ErrorMessage

取得或設定錯誤訊息,此錯誤訊息會在驗證失敗時與驗證控制項產生關聯。Gets or sets an error message to associate with a validation control if validation fails.

(繼承來源 ValidationAttribute)
ErrorMessageResourceName

取得或設定要在驗證失敗時用來查閱 ErrorMessageResourceType 屬性值的錯誤訊息資源名稱。Gets or sets the error message resource name to use in order to look up the ErrorMessageResourceType property value if validation fails.

(繼承來源 ValidationAttribute)
ErrorMessageResourceType

取得或設定資源類型,此類型可在驗證失敗時用於查閱錯誤訊息。Gets or sets the resource type to use for error-message lookup if validation fails.

(繼承來源 ValidationAttribute)
ErrorMessageString

取得當地語系化的驗證錯誤訊息。Gets the localized validation error message.

(繼承來源 ValidationAttribute)
Maximum

取得允許的最大欄位值。Gets the maximum allowed field value.

Minimum

取得允許的最小欄位值。Gets the minimum allowed field value.

OperandType

取得必須驗證其值的資料欄位型別。Gets the type of the data field whose value must be validated.

ParseLimitsInInvariantCulture

取得或設定值,決定是要使用不因文化特性而異,還是目前的文化特性 (Culture) 來剖析 MinimumMaximum 的字串值。Gets or sets a value that determines whether string values for Minimum and Maximum are parsed using the invariant culture rather than the current culture.

RequiresValidationContext

取得值,這個值表示屬性是否需要驗證內容。Gets a value that indicates whether the attribute requires validation context.

(繼承來源 ValidationAttribute)
TypeId

在衍生類別中實作時,取得這個 Attribute 的唯一識別碼。When implemented in a derived class, gets a unique identifier for this Attribute.

(繼承來源 Attribute)

方法

Equals(Object)

傳回值,這個值指出此執行個體是否與指定的物件相等。Returns a value that indicates whether this instance is equal to a specified object.

(繼承來源 Attribute)
FormatErrorMessage(String)

格式化在範圍驗證失敗時所顯示的錯誤訊息。Formats the error message that is displayed when range validation fails.

GetHashCode()

傳回這個執行個體的雜湊碼。Returns the hash code for this instance.

(繼承來源 Attribute)
GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(繼承來源 Object)
GetValidationResult(Object, ValidationContext)

檢查指定的值在目前的驗證屬性方面是否有效。Checks whether the specified value is valid with respect to the current validation attribute.

(繼承來源 ValidationAttribute)
IsDefaultAttribute()

在衍生類別中覆寫時,表示這個執行個體的值是衍生類別的預設值。When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(繼承來源 Attribute)
IsValid(Object)

檢查資料欄位的值是否在指定的範圍內。Checks that the value of the data field is in the specified range.

IsValid(Object, ValidationContext)

根據目前的驗證屬性,驗證指定的值。Validates the specified value with respect to the current validation attribute.

(繼承來源 ValidationAttribute)
Match(Object)

在衍生類別中覆寫時,會傳回值,表示這個執行個體是否等於指定物件。When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(繼承來源 Attribute)
MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(繼承來源 Object)
Validate(Object, String)

驗證指定的物件。Validates the specified object.

(繼承來源 ValidationAttribute)
Validate(Object, ValidationContext)

驗證指定的物件。Validates the specified object.

(繼承來源 ValidationAttribute)

明確介面實作

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

將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。Maps a set of names to a corresponding set of dispatch identifiers.

(繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

擷取物件的類型資訊,可以用來取得介面的類型資訊。Retrieves the type information for an object, which can be used to get the type information for an interface.

(繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

擷取物件提供的類型資訊介面數目 (0 或 1)。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

提供物件所公開的屬性和方法的存取權。Provides access to properties and methods exposed by an object.

(繼承來源 Attribute)

適用於