TimeSpanMinutesConverter

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

TimeSpanMinutesConverter クラス

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

分単位で表された期間を変換します。

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

Visual Basic (宣言)

Public Class TimeSpanMinutesConverter
    Inherits ConfigurationConverterBase

Visual Basic (使用法)

Dim instance As TimeSpanMinutesConverter

C#

public class TimeSpanMinutesConverter : ConfigurationConverterBase

C++

public ref class TimeSpanMinutesConverter :
 public ConfigurationConverterBase

J#

public class TimeSpanMinutesConverter extends
 ConfigurationConverterBase

JScript

public class TimeSpanMinutesConverter extends
 ConfigurationConverterBase

解説

この型は、他のすべての構成コンバータ型と同様に、構成ファイル内に存在する文字列と、関連する厳密に型指定されたプロパティとの間の変換を行います。

特に、TimeSpanMinutesConverter は、構成プロパティに代入された String の時間 (分単位) から TimeSpan の時間 (分単位) への変換、およびその逆の変換を行います。

TimeSpanMinutesConverter は、時間 (分単位) を表す long 型の値を永続化します。

使用例

カスタムの TimeSpanMinutesConverter 型を定義する方法を次のコード例に示します。

Visual Basic

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Globalization
Imports System.ComponentModel




NotInheritable Public Class
 CustomTimeSpanMinutesConverter
    Inherits ConfigurationConverterBase
    
    Friend Function ValidateType(ByVal
 value As Object, _
    ByVal expected As Type) As
 Boolean
        Dim result As Boolean

        If Not (value Is
 Nothing) _
        AndAlso value.ToString() <> expected.ToString()
 Then
            result = False
        Else
            result = True
        End If
        Return result

    End Function 'ValidateType
    
    
    Public Overrides Function
 CanConvertTo( _
    ByVal ctx As ITypeDescriptorContext, _
    ByVal type As Type) As
 Boolean
        Return (type.ToString() = GetType(String).ToString())

    End Function 'CanConvertTo
    
    Public Overrides Function
 CanConvertFrom( _
    ByVal ctx As ITypeDescriptorContext, _
    ByVal type As Type) As
 Boolean
        Return (type.ToString() = GetType(String).ToString())

    End Function 'CanConvertFrom
    
    Public Overrides Function
 ConvertTo( _
    ByVal ctx As ITypeDescriptorContext, _
    ByVal ci As CultureInfo, ByVal
 value As Object, _
    ByVal type As Type) As
 Object
        ValidateType(value, GetType(TimeSpan))

        Dim data As Long
 = _
        Fix(CType(value, TimeSpan).TotalMinutes)

        Return data.ToString(CultureInfo.InvariantCulture)

    End Function 'ConvertTo
    
    Public Overrides Function
 ConvertFrom( _
    ByVal ctx As ITypeDescriptorContext, _
    ByVal ci As CultureInfo, ByVal
 data As Object) As Object

        Dim min As Long
 = _
        Long.Parse(CStr(data), CultureInfo.InvariantCulture)

        Return TimeSpan.FromMinutes(System.Convert.ToDouble(min))

    End Function 'ConvertFrom

End Class 'CustomTimeSpanMinutesConverter
 

C#

using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Globalization;
using System.ComponentModel;


public sealed class CustomTimeSpanMinutesConverter
 :
    ConfigurationConverterBase
{
    internal bool ValidateType(object value, 
        Type expected)
    {
        bool result;

        if ((value != null) &&
            (value.GetType() != expected))
            result = false;
        else
            result = true;

        return result;
    }

    public override bool CanConvertTo(
        ITypeDescriptorContext ctx, Type type)
    {
        return (type == typeof(string));
    }

    public override bool CanConvertFrom(
        ITypeDescriptorContext ctx, Type type)
    {
        return (type == typeof(string));
    }

    public override object ConvertTo(
        ITypeDescriptorContext ctx, CultureInfo ci,
        object value, Type type)
    {
        ValidateType(value, typeof(TimeSpan));

        long data = (long)(((TimeSpan)value).TotalMinutes);

        return data.ToString(CultureInfo.InvariantCulture);
    }

    public override object ConvertFrom(
        ITypeDescriptorContext ctx, CultureInfo ci, object data)
    {

        long min = long.Parse((string)data,
            CultureInfo.InvariantCulture);

        return TimeSpan.FromMinutes((double)min);
    }

}

前述の例で使用されている構成の抜粋を次に示します。

<configuration>

  <configSections>
    <section name="CustomSection"
      type="Samples.AspNet.CustomSection,
      ConfigurationConverters,
      Version=1.0.0.0, Culture=neutral,
      PublicKeyToken=null"
      allowDefinition="Everywhere"
      allowExeDefinition="MachineToApplication"
      restartOnExternalChanges="true" />
  </configSections>

  <CustomSection fileName="default.txt" maxIdleTime="90" 
    timeDelay="infinite" cdStr="str0, str1" permission="Read" 
    maxUsers="Infinite"/>

</configuration>

継承階層

System.Object
   System.ComponentModel.TypeConverter
     System.Configuration.ConfigurationConverterBase
      System.Configuration.TimeSpanMinutesConverter
         System.Configuration.TimeSpanMinutesOrInfiniteConverter

スレッド セーフ

この型の 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

参照

関連項目
TimeSpanMinutesConverter メンバ
System.Configuration 名前空間
GenericEnumConverter クラス
InfiniteIntConverter クラス
InfiniteTimeSpanConverter クラス
TimeSpanMinutesOrInfiniteConverter
TimeSpanSecondsConverter
TimeSpanSecondsOrInfiniteConverter
TypeNameConverter
WhiteSpaceTrimStringConverter

TimeSpanMinutesConverter コンストラクタ

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New TimeSpanMinutesConverter

C#

public TimeSpanMinutesConverter ()

C++

public:
TimeSpanMinutesConverter ()

J#

public TimeSpanMinutesConverter ()

JScript

public function TimeSpanMinutesConverter ()

解説

通常は、システムに用意されているコンバータ型を使用します。TimeSpanMinutesConverter コンストラクタを使用する必要があるのは、独自のコンバータ型を作成する場合だけです。

プラットフォーム

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

参照

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

TimeSpanMinutesConverter メソッド

パブリック メソッド

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

	名前	説明
	CanConvertFrom	オーバーロードされます。 変換できるかどうかを確認します。 ( ConfigurationConverterBase から継承されます。)
	CanConvertTo	オーバーロードされます。 変換できるかどうかを確認します。 ( ConfigurationConverterBase から継承されます。)
	ConvertFrom	オーバーロードされます。 String を TimeSpan に変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 ( TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 ( TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 TimeSpan を String に変換します。
	ConvertToInvariantString	オーバーロードされます。 指定した値を、インバリアント カルチャを使用した文字列形式に変換します。 ( TypeConverter から継承されます。)
	ConvertToString	オーバーロードされます。 指定した値を文字列形式に変換します。 ( TypeConverter から継承されます。)
	CreateInstance	オーバーロードされます。 Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。 ( TypeConverter から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetCreateInstanceSupported	オーバーロードされます。 このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。 ( TypeConverter から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetProperties	オーバーロードされます。 value パラメータに指定された配列型のプロパティのコレクションを返します。 ( TypeConverter から継承されます。)
	GetPropertiesSupported	オーバーロードされます。 オブジェクトがプロパティをサポートしているかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetStandardValues	オーバーロードされます。 型コンバータがデザインされた対象のデータ型の標準値のコレクションを返します。 ( TypeConverter から継承されます。)
	GetStandardValuesExclusive	オーバーロードされます。 GetStandardValues から返された標準値のコレクションが、排他的なリストかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetStandardValuesSupported	オーバーロードされます。 リストから選択できる標準値セットをオブジェクトがサポートするかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsValid	オーバーロードされます。 指定した値オブジェクトが型に対して有効かどうかを示す値を返します。 ( TypeConverter から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetConvertFromException	変換を実行できなかった場合にスローされる例外を返します。 ( TypeConverter から継承されます。)
	GetConvertToException	変換を実行できなかった場合にスローされる例外を返します。 ( TypeConverter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	SortProperties	プロパティのコレクションを並べ替えます。 ( TypeConverter から継承されます。)

参照

関連項目

TimeSpanMinutesConverter クラス
System.Configuration 名前空間
GenericEnumConverter クラス
InfiniteIntConverter クラス
InfiniteTimeSpanConverter クラス
TimeSpanMinutesOrInfiniteConverter
TimeSpanSecondsConverter
TimeSpanSecondsOrInfiniteConverter
TypeNameConverter
WhiteSpaceTrimStringConverter

TimeSpanMinutesConverter メンバ

分単位で表された期間を変換します。

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

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

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

パブリック メソッド

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

	名前	説明
	CanConvertFrom	オーバーロードされます。 変換できるかどうかを確認します。 (ConfigurationConverterBase から継承されます。)
	CanConvertTo	オーバーロードされます。 変換できるかどうかを確認します。 (ConfigurationConverterBase から継承されます。)
	ConvertFrom	オーバーロードされます。 String を TimeSpan に変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 (TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 (TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 TimeSpan を String に変換します。
	ConvertToInvariantString	オーバーロードされます。 指定した値を、インバリアント カルチャを使用した文字列形式に変換します。 (TypeConverter から継承されます。)
	ConvertToString	オーバーロードされます。 指定した値を文字列形式に変換します。 (TypeConverter から継承されます。)
	CreateInstance	オーバーロードされます。 Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。 (TypeConverter から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetCreateInstanceSupported	オーバーロードされます。 このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。 (TypeConverter から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetProperties	オーバーロードされます。 value パラメータに指定された配列型のプロパティのコレクションを返します。 (TypeConverter から継承されます。)
	GetPropertiesSupported	オーバーロードされます。 オブジェクトがプロパティをサポートしているかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetStandardValues	オーバーロードされます。 型コンバータがデザインされた対象のデータ型の標準値のコレクションを返します。 (TypeConverter から継承されます。)
	GetStandardValuesExclusive	オーバーロードされます。 GetStandardValues から返された標準値のコレクションが、排他的なリストかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetStandardValuesSupported	オーバーロードされます。 リストから選択できる標準値セットをオブジェクトがサポートするかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsValid	オーバーロードされます。 指定した値オブジェクトが型に対して有効かどうかを示す値を返します。 (TypeConverter から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetConvertFromException	変換を実行できなかった場合にスローされる例外を返します。 (TypeConverter から継承されます。)
	GetConvertToException	変換を実行できなかった場合にスローされる例外を返します。 (TypeConverter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	SortProperties	プロパティのコレクションを並べ替えます。 (TypeConverter から継承されます。)

参照

関連項目

TimeSpanMinutesConverter クラス
System.Configuration 名前空間
GenericEnumConverter クラス
InfiniteIntConverter クラス
InfiniteTimeSpanConverter クラス
TimeSpanMinutesOrInfiniteConverter
TimeSpanSecondsConverter
TimeSpanSecondsOrInfiniteConverter
TypeNameConverter
WhiteSpaceTrimStringConverter