TypeNameConverter

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

TypeNameConverter クラス

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

型と文字列値との間の変換を行います。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 TypeNameConverter
    Inherits ConfigurationConverterBase

Visual Basic (使用法)

Dim instance As TypeNameConverter

C#

public sealed class TypeNameConverter : ConfigurationConverterBase

C++

public ref class TypeNameConverter sealed :
 public ConfigurationConverterBase

J#

public final class TypeNameConverter extends
 ConfigurationConverterBase

JScript

public final class TypeNameConverter extends
 ConfigurationConverterBase

解説

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

特に、TypeNameConverter は、構成型に代入された String 値から Type 値への変換、およびその逆の変換を行います。ここで説明している型は、関連付けられている構成を処理するクラスです。

使用例

カスタム セクションに関連付けられている型を取得する方法を次のコード例に示します。

カスタム セクションの実装については、ConfigurationConverterBase クラスのリファレンスにあるコード例を参照してください。

Visual Basic

Imports System
Imports System.IO
Imports System.ComponentModel
Imports System.Configuration




NotInheritable Public Class
 UsingTypeNameConverter
    
    Public Shared Sub GetTypeName()
 
        Try
            
            Dim section As CustomSection =
 _
            ConfigurationManager.GetSection("CustomSection")
            Console.WriteLine( _
            "CustomSection type: {0}", section)
        Catch e As System.Exception
            Console.WriteLine(e.Message)
        End Try
    
    End Sub 'GetTypeName
End Class 'UsingTypeNameConverter
 

C#

using System;
using System.IO;
using System.ComponentModel;
using System.Configuration;

namespace Samples.AspNet
{
  
    public sealed class UsingTypeNameConverter
    {
        public static void
 GetTypeName()
        {
            try
            {
           
                CustomSection section =
                    ConfigurationManager.GetSection("CustomSection")
                    as CustomSection;

                Console.WriteLine("CustomSection type: {0}",
                    section);
            }
            catch (System.Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }

    }
}

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

<?xml version="1.0" encoding="utf-8"?>
<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.TypeNameConverter

スレッド セーフ

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

参照

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

TypeNameConverter コンストラクタ

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New TypeNameConverter

C#

public TypeNameConverter ()

C++

public:
TypeNameConverter ()

J#

public TypeNameConverter ()

JScript

public function TypeNameConverter ()

解説

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

プラットフォーム

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

参照

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

TypeNameConverter メソッド

パブリック メソッド

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

	名前	説明
	CanConvertFrom	オーバーロードされます。 変換できるかどうかを確認します。 ( ConfigurationConverterBase から継承されます。)
	CanConvertTo	オーバーロードされます。 変換できるかどうかを確認します。 ( ConfigurationConverterBase から継承されます。)
	ConvertFrom	オーバーロードされます。 String を Type に変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 ( TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 ( TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 Type を 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 から継承されます。)

参照

関連項目

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

TypeNameConverter メンバ

型と文字列値との間の変換を行います。このクラスは継承できません。

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

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

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

パブリック メソッド

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

	名前	説明
	CanConvertFrom	オーバーロードされます。 変換できるかどうかを確認します。 (ConfigurationConverterBase から継承されます。)
	CanConvertTo	オーバーロードされます。 変換できるかどうかを確認します。 (ConfigurationConverterBase から継承されます。)
	ConvertFrom	オーバーロードされます。 String を Type に変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 (TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 (TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 Type を 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 から継承されます。)

参照

関連項目

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