TypeDescriptor.GetAssociation メソッド

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

TypeDescriptor.GetAssociation メソッド

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

指定したプライマリ オブジェクトに関連付けられた型のインスタンスを返します。

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

Visual Basic (宣言)

Public Shared Function GetAssociation
 ( _
    type As Type, _
    primary As Object _
) As Object

Visual Basic (使用法)

Dim type As Type
Dim primary As Object
Dim returnValue As Object

returnValue = TypeDescriptor.GetAssociation(type, primary)

C#

public static Object GetAssociation (
    Type type,
    Object primary
)

C++

public:
static Object^ GetAssociation (
    Type^ type, 
    Object^ primary
)

J#

public static Object GetAssociation (
    Type type, 
    Object primary
)

JScript

public static function GetAssociation
 (
    type : Type, 
    primary : Object
) : Object

パラメータ

type

対象のコンポーネントの Type。

primary

関連付けのプライマリ オブジェクト。

戻り値
関連付けが存在する場合は、プライマリ オブジェクトに関連付けられているセカンダリの型のインスタンス。指定した関連付けが存在しない場合は primary。

例外

例外の種類	条件
ArgumentNullException	パラメータの一方または両方が null 参照 (Visual Basic では Nothing) です。

解説

CreateAssociation メソッドを使用して、type パラメータに対して関連付けが既に作成されている場合、GetAssociation メソッドは、要求された型に対して呼び出す適切なセカンダリ オブジェクトを返します。それ以外の場合は、GetAssociation は type の互換性のあるデザイナを検索し、該当するデザイナが見つかればそのデザイナを返します。このメソッドが null 参照 (Visual Basic では Nothing) を返すことはありません。

プライマリ オブジェクトとセカンダリ オブジェクト間の関連付けの維持には、WeakReference が使用されます。したがって、このメソッドは、プライマリ オブジェクトまたはセカンダリ オブジェクトのいずれかが終了したり、ガベージ コレクションによってクリアされたりするのを妨げることはありません。

プラットフォーム

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

参照

関連項目
TypeDescriptor クラス
TypeDescriptor メンバ
System.ComponentModel 名前空間
GetDesigner
CreateAssociation
RemoveAssociation