RangeAttribute 類別

定義

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.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

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type RangeAttribute = class
    inherit ValidationAttribute

Public Class RangeAttribute
Inherits ValidationAttribute

繼承

Object

Attribute

ValidationAttribute

RangeAttribute

屬性

AttributeUsageAttribute

範例

下列範例顯示如何使用 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 2008Microsoft Visual Studio 2008 Service Pack 1 或 Visual Web Developer 2008 Express 版Visual Web Developer 2008 Express Edition SP1。Service Pack 1 or Visual Web Developer 2008 Express 版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, 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.

建構函式

屬性

方法

明確介面實作

適用於