TimeSpanValidatorAttribute

.NET Framework クラス ライブラリ リファレンス

TimeSpanValidatorAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

.NET Framework が構成プロパティに対して時間の検証を実行するように、宣言によって指示します。このクラスは継承できません。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Property)> _
Public NotInheritable Class
 TimeSpanValidatorAttribute
    Inherits ConfigurationValidatorAttribute

Visual Basic (使用法)

Dim instance As TimeSpanValidatorAttribute

C#

[AttributeUsageAttribute(AttributeTargets.Property)] 
public sealed class TimeSpanValidatorAttribute
 : ConfigurationValidatorAttribute

C++

[AttributeUsageAttribute(AttributeTargets::Property)] 
public ref class TimeSpanValidatorAttribute
 sealed : public ConfigurationValidatorAttribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Property) */ 
public final class TimeSpanValidatorAttribute
 extends ConfigurationValidatorAttribute

JScript

AttributeUsageAttribute(AttributeTargets.Property) 
public final class TimeSpanValidatorAttribute
 extends ConfigurationValidatorAttribute

解説

TimeSpanValidatorAttribute を使用して、構成プロパティを装飾します。これは、.NET Framework に TimeSpanValidator を使用してプロパティを検証するように指示し、装飾のパラメータの値を渡すためです。

TimeSpanValidatorAttribute オブジェクトは、プロパティ型だけに適用できます。

使用例

TimeSpanValidatorAttribute オブジェクトを使用して、カスタム ConfigurationSection オブジェクトのプロパティを装飾する方法を、次のコード例に示します。

Visual Basic

<ConfigurationProperty("maxIdleTime", _
DefaultValue:="0:10:0", _
IsRequired:=False), _
TimeSpanValidator(MinValueString:="0:0:30", _
MaxValueString:="5:00:0", _
ExcludeRange:=False)> _
Public Property MaxIdleTime() As
 TimeSpan
    Get
        Return CType(Me("maxIdleTime"),
 TimeSpan)
    End Get
    Set(ByVal value As TimeSpan)
        Me("maxIdleTime") = value
    End Set
End Property

C#

[ConfigurationProperty("maxIdleTime",
    DefaultValue = "0:10:0",
    IsRequired = false)]
[TimeSpanValidator(MinValueString = "0:0:30",
    MaxValueString = "5:00:0",
    ExcludeRange = false)]
public TimeSpan MaxIdleTime
{
    get
    {
        return (TimeSpan)this["maxIdleTime"];
    }
    set
    {
        this["maxIdleTime"] = value;
    }
}

次に示すのは、前述の例で使用されているカスタム セクションを含んだ構成ファイルの抜粋です。

<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">
  <configSections>
    <section name="custom" type="Microsoft.Samples.AspNet.Configuration.SampleSection,
 ConfigurationValidatorAttribute" />
  </configSections>
  <custom fileName="NewFile.txt" maxSize="1000" maxAttempts="101" maxUsers="2500"
 maxIdleTime="00:15:00" />
</configuration>

継承階層

System.Object
   System.Attribute
     System.Configuration.ConfigurationValidatorAttribute
      System.Configuration.TimeSpanValidatorAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TimeSpanValidatorAttribute メンバ
System.Configuration 名前空間
ConfigurationValidatorAttribute クラス
ConfigurationSection クラス
ConfigurationPropertyAttribute クラス
TimeSpanValidator クラス

TimeSpanValidatorAttribute コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

TimeSpanValidatorAttribute クラスの新しいインスタンスを初期化します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New TimeSpanValidatorAttribute

C#

public TimeSpanValidatorAttribute ()

C++

public:
TimeSpanValidatorAttribute ()

J#

public TimeSpanValidatorAttribute ()

JScript

public function TimeSpanValidatorAttribute
 ()

解説

このコンストラクタを属性付きモデルで使用し、関連するプロパティに、確実に TimeSpan 型の値が割り当てられるようにします。

使用例

StringValidatorAttribute コンストラクタを使用する例を次に示します。

Visual Basic

        Dim valBase As ConfigurationValidatorBase
        Dim tsValAttr As TimeSpanValidatorAttribute
        tsValAttr = New TimeSpanValidatorAttribute()

        Dim goodValue As TimeSpan = TimeSpan.FromMinutes(10)
        Dim badValue As Int16 = 10

        Try
            valBase = tsValAttr.ValidatorInstance
            valBase.Validate(goodValue)
            ' valBase.Validate(badValue);
        Catch e As ArgumentException
            ' Display error message.
            Dim msg As String
 = e.ToString()

#If DEBUG Then
            Console.WriteLine(msg)
#End If
        End Try '

C#

            ConfigurationValidatorBase valBase;
            TimeSpanValidatorAttribute tsValAttr;
            tsValAttr = new TimeSpanValidatorAttribute();

            TimeSpan goodValue = TimeSpan.FromMinutes(10);
            Int16 badValue = 10;

            try
            {
                valBase = tsValAttr.ValidatorInstance;
                valBase.Validate(goodValue);
                // valBase.Validate(badValue);
            }
            catch (ArgumentException e)
            {
                // Display error message.
                string msg = e.ToString();
#if DEBUG
                Console.WriteLine(msg);
#endif
            }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TimeSpanValidatorAttribute クラス
TimeSpanValidatorAttribute メンバ
System.Configuration 名前空間

TimeSpanValidatorAttribute フィールド

パブリック フィールド

	名前	説明
	TimeSpanMaxValue	指定できる最大の絶対値を取得します。
	TimeSpanMinValue	指定できる最小の絶対値を取得します。

参照

関連項目

TimeSpanValidatorAttribute クラス
System.Configuration 名前空間
ConfigurationValidatorAttribute クラス
ConfigurationSection クラス
ConfigurationPropertyAttribute クラス
TimeSpanValidator クラス

TimeSpanValidatorAttribute プロパティ

パブリック プロパティ

	名前	説明
	ExcludeRange	整数を、MinValueString と MaxValueString によって定義された範囲内に含めるか、その範囲から除外するかを示す値を取得または設定します。
	MaxValue	指定できる最大の絶対値。
	MaxValueString	指定できる最大の相対値。
	MinValue	指定できる最小の絶対値。
	MinValueString	指定できる最小の相対値。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)
	ValidatorInstance	オーバーライドされます。 TimeSpanValidator のインスタンスを取得します。
	ValidatorType	検証コントロールの属性の型を取得します。 ( ConfigurationValidatorAttribute から継承されます。)

参照

関連項目

TimeSpanValidatorAttribute クラス
System.Configuration 名前空間
ConfigurationValidatorAttribute クラス
ConfigurationSection クラス
ConfigurationPropertyAttribute クラス
TimeSpanValidator クラス

TimeSpanValidatorAttribute メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 ( Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。)
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

TimeSpanValidatorAttribute クラス
System.Configuration 名前空間
ConfigurationValidatorAttribute クラス
ConfigurationSection クラス
ConfigurationPropertyAttribute クラス
TimeSpanValidator クラス

TimeSpanValidatorAttribute メンバ

.NET Framework が構成プロパティに対して時間の検証を実行するように、宣言によって指示します。このクラスは継承できません。

TimeSpanValidatorAttribute データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	TimeSpanValidatorAttribute	TimeSpanValidatorAttribute クラスの新しいインスタンスを初期化します。

パブリック フィールド

	名前	説明
	TimeSpanMaxValue	指定できる最大の絶対値を取得します。
	TimeSpanMinValue	指定できる最小の絶対値を取得します。

パブリック プロパティ

	名前	説明
	ExcludeRange	整数を、MinValueString と MaxValueString によって定義された範囲内に含めるか、その範囲から除外するかを示す値を取得または設定します。
	MaxValue	指定できる最大の絶対値。
	MaxValueString	指定できる最大の相対値。
	MinValue	指定できる最小の絶対値。
	MinValueString	指定できる最小の相対値。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)
	ValidatorInstance	オーバーライドされます。 TimeSpanValidator のインスタンスを取得します。
	ValidatorType	検証コントロールの属性の型を取得します。(ConfigurationValidatorAttribute から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 (Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

TimeSpanValidatorAttribute クラス
System.Configuration 名前空間
ConfigurationValidatorAttribute クラス
ConfigurationSection クラス
ConfigurationPropertyAttribute クラス
TimeSpanValidator クラス