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。

• データ ドリブン Web サイト。 これにより、カスタマイズするデータ フィールドを含むデータベースとクラスのデータ コンテキストを作成できます。 詳細については、「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	コンストラクターの パラメーターによってtype設定された に検証OperandTypeされる値の変換で、インバリアント カルチャまたは現在のRangeAttribute(Type, String, String)カルチャを使用するかどうかを決定する値を取得または設定します。
ErrorMessage	検証が失敗した場合に検証コントロールに関連付けるエラー メッセージを取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageResourceName	検証が失敗した場合に ErrorMessageResourceType プロパティ値の検索に使用するエラー メッセージ リソース名を取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageResourceType	検証が失敗した場合にエラー メッセージの検索に使用するリソースの種類を取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageString	ローカライズされた検証エラー メッセージを取得します。 (継承元 ValidationAttribute)
Maximum	最大許容フィールド値を取得します。
MaximumIsExclusive	と等しい Maximum値に対して検証を失敗させるかどうかを指定します。
Minimum	最小許容フィールド値を取得します。
MinimumIsExclusive	と等しい Minimum値に対して検証を失敗させるかどうかを指定します。
OperandType	値を検証する必要があるデータ フィールドの型を取得します。
ParseLimitsInInvariantCulture	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)