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 クラス