TypeDescriptor

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

TypeDescriptor イベント

パブリック イベント

	名前	説明
	Refreshed	コンポーネントのキャッシュが消去されたときに発生します。

参照

関連項目

TypeDescriptor クラス
System.ComponentModel 名前空間
EventDescriptor クラス
PropertyDescriptor クラス
System.Reflection
IComponent インターフェイス
ISite インターフェイス

その他の技術情報

型記述子の概要
リフレクション

TypeDescriptor クラス

属性、プロパティ、イベントなど、コンポーネントの特性に関する情報を提供します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 TypeDescriptor

Visual Basic (使用法)

Dim instance As TypeDescriptor

C#

public sealed class TypeDescriptor

C++

public ref class TypeDescriptor sealed

J#

public final class TypeDescriptor

JScript

public final class TypeDescriptor

解説

.NET Framework では、System.Reflection 名前空間で提供されるリフレクション API と TypeDescriptor クラスという 2 とおりの方法で型のメタデータにアクセスできます。リフレクションの基盤は、ルート クラス Object の GetType メソッドで確立されるため、リフレクションはすべての型で使用できる汎用機構です。リフレクションによって返される型に関する情報は、対象の型をコンパイルした後に変更できないという点で拡張性がありません。詳細については、リフレクション のトピックを参照してください。

これに対して、TypeDescriptor はコンポーネントに対して拡張性のある検査機構です。これらのクラスは、IComponent インターフェイスを実装しています。リフレクションとは異なり、このクラスはメソッドに関する検査は行いません。TypeDescriptor は、対象のコンポーネントの Site を通じて利用できる複数のサービスによって動的に拡張できます。これらのサービスを次の表に示します。

サービス名	説明
IExtenderProvider	ToolTip などの別のクラスがコンポーネントに追加のプロパティを提供できるようにします。
ITypeDescriptorFilterService	別のオブジェクトがコンポーネントによって公開される標準のメタデータを変更できるようにします。
ICustomTypeDescriptor	TypeDescriptor の標準の検査機構を置き換え、クラスが独自のメタデータを完全かつ動的に指定できるようにします。

TypeDescriptor によって提供される機能拡張を使用すると、コンポーネントのデザイン時の表現を実行時の実際の表現と区別できるため、TypeDescriptor は、デザイン時のインフラストラクチャを構築する際に役立ちます。

TypeDescriptor のすべてのメソッドは static です。このクラスのインスタンスは作成できないため、このクラスを継承することはできません。

プロパティとイベントの値を設定するには、コンポーネント クラスで指定する方法と、デザイン時に変更する方法の 2 とおりあります。2 とおりの方法でこれらの値を設定できるため、TypeDescriptor のオーバーロードされたメソッドには、クラス型またはオブジェクトのインスタンスという 2 種類のパラメータの型を指定できます。

TypeDescriptor の情報にアクセスする必要があり、オブジェクトのインスタンスがある場合は、コンポーネントを呼び出すメソッドを使用します。クラス型を呼び出すメソッドは、オブジェクトのインスタンスがない場合にだけ使用します。

処理速度向上のため、プロパティとイベントは TypeDescriptor によってキャッシュされます。通常、これらはオブジェクトの有効期間を通じて一定です。ただし、拡張プロバイダやデザイナは、オブジェクトに関する一連のプロパティを変更できます。その場合、Refresh メソッドを呼び出してキャッシュを更新する必要があります。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

継承階層

System.Object
  System.ComponentModel.TypeDescriptor

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TypeDescriptor メンバ
System.ComponentModel 名前空間
EventDescriptor クラス
PropertyDescriptor クラス
System.Reflection
IComponent インターフェイス
ISite インターフェイス
その他の技術情報
型記述子の概要
リフレクション

TypeDescriptor プロパティ

パブリック プロパティ

	名前	説明
	ComNativeDescriptorHandler	対象のコンポーネントのコンポーネント オブジェクト モデル (COM: Component Object Model) 型情報のプロバイダを取得または設定します。
	ComObjectType	対象のコンポーネントによって表されるコンポーネント オブジェクト モデル (COM: Component Object Model) オブジェクトの型を取得します。

参照

関連項目

TypeDescriptor クラス
System.ComponentModel 名前空間
EventDescriptor クラス
PropertyDescriptor クラス
System.Reflection
IComponent インターフェイス
ISite インターフェイス

その他の技術情報

型記述子の概要
リフレクション

TypeDescriptor メソッド

パブリック メソッド

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

	名前	説明
	AddAttributes	オーバーロードされます。 対象のコンポーネントにクラス レベルの属性を追加します。
	AddEditorTable	指定したエディタの基本型のエディタ テーブルを追加します。
	AddProvider	オーバーロードされます。 この型記述子のプロバイダのリストに型の記述プロバイダを追加します。
	CreateAssociation	2 つのオブジェクト間にプライマリとセカンダリの関連付けを作成します。
	CreateDesigner	指定したコンポーネントに関連付けられているデザイナのインスタンスと、指定したデザイナの型のインスタンスを作成します。
	CreateEvent	オーバーロードされます。 既存のイベント記述子と同一の新しいイベント記述子を作成します。
	CreateInstance	別のデータ型の代わりに使用できるオブジェクトを作成します。
	CreateProperty	オーバーロードされます。 コンポーネントの既存のプロパティの新しいプロパティ記述子を作成します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetAssociation	指定したプライマリ オブジェクトに関連付けられた型のインスタンスを返します。
	GetAttributes	オーバーロードされます。 コンポーネントまたは型の属性のコレクションを返します。
	GetClassName	オーバーロードされます。 指定したコンポーネントのクラスの名前を返します。
	GetComponentName	オーバーロードされます。 指定したコンポーネントの名前を返します。
	GetConverter	オーバーロードされます。 コンポーネントまたは型の型コンバータを返します。
	GetDefaultEvent	オーバーロードされます。 コンポーネントまたは型の既定のイベントを返します。
	GetDefaultProperty	オーバーロードされます。 コンポーネントの既定のプロパティを返します。
	GetEditor	オーバーロードされます。 指定した基本型のエディタを返します。
	GetEvents	オーバーロードされます。 コンポーネントまたは型のイベントのコレクションを返します。
	GetFullComponentName	コンポーネントの完全修飾名を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetProperties	オーバーロードされます。 コンポーネントまたは型のプロパティのコレクションを返します。
	GetProvider	オーバーロードされます。 コンポーネントまたは型の型記述プロバイダを返します。
	GetReflectionType	オーバーロードされます。 リフレクションの実行に使用できる Type を返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Refresh	オーバーロードされます。 プロパティとイベントをキャッシュから消去します。
	RemoveAssociation	2 つのオブジェクト間の関連付けを削除します。
	RemoveAssociations	プライマリ オブジェクトのすべての関連付けを削除します。
	RemoveProvider	オーバーロードされます。 以前に追加した型の記述プロバイダを削除します。
	SortDescriptorArray	記述子を名前で並べ替えます。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

TypeDescriptor クラス
System.ComponentModel 名前空間
EventDescriptor クラス
PropertyDescriptor クラス
System.Reflection
IComponent インターフェイス
ISite インターフェイス

その他の技術情報

型記述子の概要
リフレクション

TypeDescriptor メンバ

属性、プロパティ、イベントなど、コンポーネントの特性に関する情報を提供します。このクラスは継承できません。

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

パブリック プロパティ

	名前	説明
	ComNativeDescriptorHandler	対象のコンポーネントのコンポーネント オブジェクト モデル (COM: Component Object Model) 型情報のプロバイダを取得または設定します。
	ComObjectType	対象のコンポーネントによって表されるコンポーネント オブジェクト モデル (COM: Component Object Model) オブジェクトの型を取得します。

パブリック メソッド

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

	名前	説明
	AddAttributes	オーバーロードされます。 対象のコンポーネントにクラス レベルの属性を追加します。
	AddEditorTable	指定したエディタの基本型のエディタ テーブルを追加します。
	AddProvider	オーバーロードされます。 この型記述子のプロバイダのリストに型の記述プロバイダを追加します。
	CreateAssociation	2 つのオブジェクト間にプライマリとセカンダリの関連付けを作成します。
	CreateDesigner	指定したコンポーネントに関連付けられているデザイナのインスタンスと、指定したデザイナの型のインスタンスを作成します。
	CreateEvent	オーバーロードされます。 既存のイベント記述子と同一の新しいイベント記述子を作成します。
	CreateInstance	別のデータ型の代わりに使用できるオブジェクトを作成します。
	CreateProperty	オーバーロードされます。 コンポーネントの既存のプロパティの新しいプロパティ記述子を作成します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetAssociation	指定したプライマリ オブジェクトに関連付けられた型のインスタンスを返します。
	GetAttributes	オーバーロードされます。 コンポーネントまたは型の属性のコレクションを返します。
	GetClassName	オーバーロードされます。 指定したコンポーネントのクラスの名前を返します。
	GetComponentName	オーバーロードされます。 指定したコンポーネントの名前を返します。
	GetConverter	オーバーロードされます。 コンポーネントまたは型の型コンバータを返します。
	GetDefaultEvent	オーバーロードされます。 コンポーネントまたは型の既定のイベントを返します。
	GetDefaultProperty	オーバーロードされます。 コンポーネントの既定のプロパティを返します。
	GetEditor	オーバーロードされます。 指定した基本型のエディタを返します。
	GetEvents	オーバーロードされます。 コンポーネントまたは型のイベントのコレクションを返します。
	GetFullComponentName	コンポーネントの完全修飾名を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetProperties	オーバーロードされます。 コンポーネントまたは型のプロパティのコレクションを返します。
	GetProvider	オーバーロードされます。 コンポーネントまたは型の型記述プロバイダを返します。
	GetReflectionType	オーバーロードされます。 リフレクションの実行に使用できる Type を返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Refresh	オーバーロードされます。 プロパティとイベントをキャッシュから消去します。
	RemoveAssociation	2 つのオブジェクト間の関連付けを削除します。
	RemoveAssociations	プライマリ オブジェクトのすべての関連付けを削除します。
	RemoveProvider	オーバーロードされます。 以前に追加した型の記述プロバイダを削除します。
	SortDescriptorArray	記述子を名前で並べ替えます。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

パブリック イベント

	名前	説明
	Refreshed	コンポーネントのキャッシュが消去されたときに発生します。

参照

関連項目

TypeDescriptor クラス
System.ComponentModel 名前空間
EventDescriptor クラス
PropertyDescriptor クラス
System.Reflection
IComponent インターフェイス
ISite インターフェイス

その他の技術情報

型記述子の概要
リフレクション