TypeDescriptionProvider.GetCache メソッド

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

TypeDescriptionProvider.GetCache メソッド

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

キー/値ペアの IDictionary としてアクセスされる、オブジェクトごとのキャッシュを取得します。

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

Visual Basic (宣言)

Public Overridable Function
 GetCache ( _
    instance As Object _
) As IDictionary

Visual Basic (使用法)

Dim instance As TypeDescriptionProvider
Dim instance As Object
Dim returnValue As IDictionary

returnValue = instance.GetCache(instance)

C#

public virtual IDictionary GetCache (
    Object instance
)

C++

public:
virtual IDictionary^ GetCache (
    Object^ instance
)

J#

public IDictionary GetCache (
    Object instance
)

JScript

public function GetCache (
    instance : Object
) : IDictionary

パラメータ

instance

キャッシュの取得対象となるオブジェクト。

戻り値
提供されるオブジェクトがキャッシュをサポートしている場合は IDictionary。それ以外の場合は null 参照 (Visual Basic では Nothing)。

解説

TypeDescriptor は、メタデータのコレクションに対して、複雑な操作を実行することが必要な場合があります。ドメインの有効期間に型はアンロードされないため、TypeDescriptor クラスは、型に基づいたこれらの操作の結果を自動的にキャッシュします。ただし、一部の操作では、ライブ オブジェクトのインスタンスを使用します。これらの操作をキャッシュすると、オブジェクトをガベージ コレクションで収集できなくなるため、TypeDescriptor クラス内にこれらの操作をキャッシュすることはできません。代わりに、TypeDescriptor クラスでは、キー/値ペアの IDictionary としてアクセスされるオブジェクトごとのキャッシュをオブジェクト上に存在させることができます。GetCache メソッドは、このキャッシュのインスタンスを返します。オブジェクトでキャッシュがサポートされていない場合、GetCache メソッドは null 参照 (Visual Basic では Nothing) を返します。

TypeDescriptor によって使用される既定の TypeDescriptionProvider は、そのオブジェクトが IDictionaryService インターフェイスを実装するサイト コンポーネントかどうかを調べます。オブジェクトがサイト コンポーネントの場合は、ディクショナリ サービスを使用してオブジェクトのキャッシュを格納します。それ以外の場合は、null 参照 (Visual Basic では Nothing) を返します。他の型説明のプロバイダは、ここで独自の実装を提供する場合があります。たとえば、依存関係オブジェクトは、IDictionary 型のプロパティだけを追加できます。

プラットフォーム

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

参照

関連項目
TypeDescriptionProvider クラス
TypeDescriptionProvider メンバ
System.ComponentModel 名前空間
IDictionary
IDictionaryService