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
継承
属性

次の例は、 を使用 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

コンストラクターの パラメーターRangeAttribute(Type, String, String)によってtype設定された値への変換で、インバリアント カルチャまたは現在のカルチャを使用するかどうかを決定する値OperandTypeを取得または設定します。

ErrorMessage

検証が失敗した場合に検証コントロールに関連付けるエラー メッセージを取得または設定します。

(継承元 ValidationAttribute)
ErrorMessageResourceName

検証が失敗した場合に ErrorMessageResourceType プロパティ値の検索に使用するエラー メッセージ リソース名を取得または設定します。

(継承元 ValidationAttribute)
ErrorMessageResourceType

検証が失敗した場合にエラー メッセージの検索に使用するリソースの種類を取得または設定します。

(継承元 ValidationAttribute)
ErrorMessageString

ローカライズされた検証エラー メッセージを取得します。

(継承元 ValidationAttribute)
Maximum

最大許容フィールド値を取得します。

MaximumIsExclusive

と等しい Maximum値に対して検証を失敗させるかどうかを指定します。

Minimum

最小許容フィールド値を取得します。

MinimumIsExclusive

と等しい Minimum値に対して検証を失敗させるかどうかを指定します。

OperandType

値を検証する必要があるデータ フィールドの型を取得します。

ParseLimitsInInvariantCulture

MinimumMaximum に対する文字列値が、現在のカルチャではなく、インバリアント カルチャを使用して解析されるかどうかを判断する値を取得または設定します。

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)

明示的なインターフェイスの実装

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

一連の名前を対応する一連のディスパッチ識別子に割り当てます。

(継承元 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。

(継承元 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。

(継承元 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。

(継承元 Attribute)

適用対象