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 aDateTime
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 Scaffolding
。For more information, seeWalkthrough: 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) 建構函式 |
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) 來剖析 Minimum 和 Maximum 的字串值。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() |
取得目前執行個體的 Type。Gets 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) |