TypeDescriptor.CreateInstance メソッド

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

TypeDescriptor.CreateInstance メソッド

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

別のデータ型の代わりに使用できるオブジェクトを作成します。

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

Visual Basic (宣言)

Public Shared Function CreateInstance
 ( _
    provider As IServiceProvider, _
    objectType As Type, _
    argTypes As Type(), _
    args As Object() _
) As Object

Visual Basic (使用法)

Dim provider As IServiceProvider
Dim objectType As Type
Dim argTypes As Type()
Dim args As Object()
Dim returnValue As Object

returnValue = TypeDescriptor.CreateInstance(provider, objectType, argTypes, args)

C#

public static Object CreateInstance (
    IServiceProvider provider,
    Type objectType,
    Type[] argTypes,
    Object[] args
)

C++

public:
static Object^ CreateInstance (
    IServiceProvider^ provider, 
    Type^ objectType, 
    array<Type^>^ argTypes, 
    array<Object^>^ args
)

J#

public static Object CreateInstance (
    IServiceProvider provider, 
    Type objectType, 
    Type[] argTypes, 
    Object[] args
)

JScript

public static function CreateInstance
 (
    provider : IServiceProvider, 
    objectType : Type, 
    argTypes : Type[], 
    args : Object[]
) : Object

パラメータ

provider

TypeDescriptionProvider サービスを提供するサービス プロバイダ。このパラメータは、null 参照 (Visual Basic では Nothing) の場合もあります。

objectType

作成するオブジェクトの Type。

argTypes

オブジェクトのコンストラクタに渡されるパラメータ型の配列 (省略可能)。このパラメータは、null 参照 (Visual Basic では Nothing) にすることも長さ 0 の配列にすることもできます。

args

オブジェクトのコンストラクタに渡されるパラメータ値の配列 (省略可能)。null 参照 (Visual Basic では Nothing) でない場合、要素の数は argTypes と同じであることが必要です。

戻り値
関連付けられた TypeDescriptionProvider が見つかった場合は、代替のデータ型のインスタンス。それ以外の場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
ArgumentNullException	objectType は null 参照 (Visual Basic では Nothing) です。または、argTypes が null 参照 (Visual Basic では Nothing) ではないときは、args が null 参照 (Visual Basic では Nothing) です。
ArgumentException	argTypes と args の要素の数が異なります。

解説

CreateInstance メソッドは、指定した objectType データ型に関連付けられた TypeDescriptionProvider を検索します。このメソッドは、まず provider パラメータから型の記述プロバイダの取得を試みます。これが失敗すると、独自の内部テーブルでプロバイダを検索します (これらのエントリは、以前の AddProvider 呼び出しによって作成されています)。プロバイダが見つかると、このメソッドは作成呼び出しをそのオブジェクトに代行させます。

継承時の注意 派生クラスが代替インスタンスを提供しない場合、このメソッドは基本実装を呼び出す必要があります。

プラットフォーム

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 名前空間
TypeDescriptionProvider.CreateInstance
GetClassName
GetComponentName
GetReflectionType
AddProvider