AppDomain.CreateInstance メソッド

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

AppDomain.CreateInstance メソッド (String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

指定したアセンブリで定義されている、指定した型の新しいインスタンスを作成します。バインダ、バインディング フラグ、コンストラクタ引数、引数を解釈するために使用するカルチャ固有の情報、アクティベーション属性、型を作成するために必要な承認情報をパラメータで指定します。

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

Visual Basic (宣言)

Public Function CreateInstance ( _
    assemblyName As String, _
    typeName As String, _
    ignoreCase As Boolean, _
    bindingAttr As BindingFlags, _
    binder As Binder, _
    args As Object(), _
    culture As CultureInfo, _
    activationAttributes As Object(), _
    securityAttributes As Evidence _
) As ObjectHandle

Visual Basic (使用法)

Dim instance As AppDomain
Dim assemblyName As String
Dim typeName As String
Dim ignoreCase As Boolean
Dim bindingAttr As BindingFlags
Dim binder As Binder
Dim args As Object()
Dim culture As CultureInfo
Dim activationAttributes As Object()
Dim securityAttributes As Evidence
Dim returnValue As ObjectHandle

returnValue = instance.CreateInstance(assemblyName, typeName, ignoreCase, bindingAttr,
 binder, args, culture, activationAttributes, securityAttributes)

C#

public ObjectHandle CreateInstance (
    string assemblyName,
    string typeName,
    bool ignoreCase,
    BindingFlags bindingAttr,
    Binder binder,
    Object[] args,
    CultureInfo culture,
    Object[] activationAttributes,
    Evidence securityAttributes
)

C++

public:
virtual ObjectHandle^ CreateInstance (
    String^ assemblyName, 
    String^ typeName, 
    bool ignoreCase, 
    BindingFlags bindingAttr, 
    Binder^ binder, 
    array<Object^>^ args, 
    CultureInfo^ culture, 
    array<Object^>^ activationAttributes, 
    Evidence^ securityAttributes
) sealed

J#

public final ObjectHandle CreateInstance (
    String assemblyName, 
    String typeName, 
    boolean ignoreCase, 
    BindingFlags bindingAttr, 
    Binder binder, 
    Object[] args, 
    CultureInfo culture, 
    Object[] activationAttributes, 
    Evidence securityAttributes
)

JScript

public final function CreateInstance (
    assemblyName : String, 
    typeName : String, 
    ignoreCase : boolean, 
    bindingAttr : BindingFlags, 
    binder : Binder, 
    args : Object[], 
    culture : CultureInfo, 
    activationAttributes : Object[], 
    securityAttributes : Evidence
) : ObjectHandle

パラメータ

assemblyName

アセンブリの表示名。詳細については、Assembly.FullName のトピックを参照してください。

typeName

要求する型の完全修飾名。アセンブリは指定せずに、名前空間だけを指定します。この名前は、Type.FullName プロパティによって返されます。

ignoreCase

検索で大文字と小文字を区別するかどうかを指定する Boolean 値。

bindingAttr

typeName コンストラクタの検索に影響を与える 0 個以上のビット フラグの組み合わせ。bindingAttr が 0 の場合は、大文字と小文字を区別してパブリック コンストラクタを検索します。

binder

バインディング、引数型の強制変換、メンバの呼び出し、および、リフレクションを使用した MemberInfo オブジェクトの取得を有効にするオブジェクト。binder が null の場合は、既定のバインダが使用されます。

args

コンストラクタに渡される引数。この引数の配列は、呼び出すコンストラクタのパラメータに対して、数、順序、および型を一致させる必要があります。既定のコンストラクタを優先する場合は、args を空の配列または null にする必要があります。

culture

args から typeName コンストラクタに対して宣言された仮型への強制変換を制御するカルチャ固有の情報。culture が null 参照 (Visual Basic では Nothing) の場合、現在のスレッドの CultureInfo が使用されます。

activationAttributes

アクティべーションに参加できる 1 つ以上の属性。

securityAttributes

typeName の作成を承認するために使用される情報。

戻り値
typeName で指定した新しいインスタンスのラッパーであるオブジェクト。実際のオブジェクトにアクセスするには、戻り値のラップを解除する必要があります。

例外

例外の種類	条件
AppDomainUnloadedException	操作が、アンロードされたアプリケーション ドメインで試行されています。
ArgumentNullException	assemblyName または typeName が null 参照 (Visual Basic では Nothing) です。
BadImageFormatException	assemblyName が有効なアセンブリではありません。
FileLoadException	1 つのアセンブリまたはモジュールが 2 つの異なる証拠を使用して 2 回読み込まれました。
FileNotFoundException	assemblyName は見つかりませんでした。
MethodAccessException	呼び出し元に、このコンストラクタを呼び出すためのアクセス許可がありません。
MissingMethodException	一致するコンストラクタが見つかりませんでした。
NotSupportedException	MarshalByRefObject から継承されていないオブジェクトに対して、呼び出し元がアクティベーション属性を与えることはできません。
TypeLoadException	assemblyName で、typename が見つかりませんでした。

解説

このメソッドは、typeName の既定のコンストラクタを呼び出します。

assemblyName の書式については、AssemblyName のトピックを参照してください。

現在のアプリケーション ドメインではない対象のアプリケーション ドメインで CreateInstance を呼び出そうとすると、対象のアプリケーション ドメインにアセンブリが正常に読み込まれます。Assembly は MarshalByRefObject ではないため、読み込まれたアセンブリに対する Assembly をこのメソッドで現在のアプリケーション ドメインに戻そうとした場合、共通言語ランタイムはアセンブリを現在のアプリケーション ドメインに読み込もうとしますが、結果的には読み込みに失敗することがあります。現在のアプリケーション ドメインと、最初にアセンブリが読み込まれたアプリケーション ドメインのパスの設定が異なる場合には、それぞれのアプリケーション ドメインに読み込まれたアセンブリは異なる場合があります。

.NET Framework のセキュリティ

• FileIOPermissionAccess  (アセンブリの場所にアクセスするために必要なアクセス許可)。FileIOPermissionAccess.PathDiscovery (関連する列挙体)
• FileIOPermissionAccess  (アセンブリ マニフェストを格納しているファイルを読み取るために必要なアクセス許可)。FileIOPermissionAccess.Read (関連する列挙体)
• WebPermission  (アセンブリがローカルにない場合にアセンブリの場所にアクセスするために必要なアクセス許可)。
• SecurityPermission  (デリゲートのインスタンスの作成時にアンマネージ コードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
• ReflectionPermission  (すべての型のメンバに対して操作を呼び出すために必要なアクセス許可)。ReflectionPermissionFlag.MemberAccess (関連する列挙体)
• SecurityPermission  (証拠を提供するために必要なアクセス許可)。SecurityPermissionFlag.ControlEvidence (関連する列挙体)

プラットフォーム

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、1.1、1.0

参照

関連項目
AppDomain クラス
AppDomain メンバ
System 名前空間
Activator.CreateInstance

AppDomain.CreateInstance メソッド (String, String, Object[])

指定したアセンブリで定義されている、指定した型の新しいインスタンスを作成します。アクティベーション属性の配列をパラメータで指定します。

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

Visual Basic (宣言)

Public Function CreateInstance ( _
    assemblyName As String, _
    typeName As String, _
    activationAttributes As Object() _
) As ObjectHandle

Visual Basic (使用法)

Dim instance As AppDomain
Dim assemblyName As String
Dim typeName As String
Dim activationAttributes As Object()
Dim returnValue As ObjectHandle

returnValue = instance.CreateInstance(assemblyName, typeName, activationAttributes)

C#

public ObjectHandle CreateInstance (
    string assemblyName,
    string typeName,
    Object[] activationAttributes
)

C++

public:
virtual ObjectHandle^ CreateInstance (
    String^ assemblyName, 
    String^ typeName, 
    array<Object^>^ activationAttributes
) sealed

J#

public final ObjectHandle CreateInstance (
    String assemblyName, 
    String typeName, 
    Object[] activationAttributes
)

JScript

public final function CreateInstance (
    assemblyName : String, 
    typeName : String, 
    activationAttributes : Object[]
) : ObjectHandle

パラメータ

assemblyName

アセンブリの表示名。詳細については、Assembly.FullName のトピックを参照してください。

typeName

要求する型の完全修飾名。アセンブリは指定せずに、名前空間だけを指定します。この名前は、Type.FullName プロパティによって返されます。

activationAttributes

アクティべーションに参加できる 1 つ以上の属性。

戻り値
typeName で指定した新しいインスタンスのラッパーであるオブジェクト。実際のオブジェクトにアクセスするには、戻り値のラップを解除する必要があります。

例外

例外の種類	条件
AppDomainUnloadedException	操作が、アンロードされたアプリケーション ドメインで試行されています。
ArgumentNullException	assemblyName または typeName が null 参照 (Visual Basic では Nothing) です。
BadImageFormatException	assemblyName が有効なアセンブリではありません。
FileLoadException	1 つのアセンブリまたはモジュールが 2 つの異なる証拠を使用して 2 回読み込まれました。
FileNotFoundException	assemblyName は見つかりませんでした。
MethodAccessException	呼び出し元に、このコンストラクタを呼び出すためのアクセス許可がありません。
MissingMethodException	一致するパブリック コンストラクタが見つかりませんでした。
NotSupportedException	MarshalByRefObject から継承されていないオブジェクトに対して、呼び出し元がアクティベーション属性を与えることはできません。
TypeLoadException	assemblyName で、typename が見つかりませんでした。

解説

このメソッドは、typeName の既定のコンストラクタを呼び出します。

assemblyName の書式については、AssemblyName のトピックを参照してください。

現在のアプリケーション ドメインではない対象のアプリケーション ドメインで CreateInstance を呼び出そうとすると、対象のアプリケーション ドメインにアセンブリが正常に読み込まれます。Assembly は MarshalByRefObject ではないため、読み込まれたアセンブリに対する Assembly をこのメソッドで現在のアプリケーション ドメインに戻そうとした場合、共通言語ランタイムはアセンブリを現在のアプリケーション ドメインに読み込もうとしますが、結果的には読み込みに失敗することがあります。現在のアプリケーション ドメインと、最初にアセンブリが読み込まれたアプリケーション ドメインのパスの設定が異なる場合には、それぞれのアプリケーション ドメインに読み込まれたアセンブリは異なる場合があります。

.NET Framework のセキュリティ

• FileIOPermissionAccess  (アセンブリの場所にアクセスするために必要なアクセス許可)。FileIOPermissionAccess.PathDiscovery (関連する列挙体)
• FileIOPermissionAccess  (アセンブリ マニフェストを格納しているファイルを読み取るために必要なアクセス許可)。FileIOPermissionAccess.Read (関連する列挙体)
• WebPermission  (アセンブリがローカルにない場合にアセンブリの場所にアクセスするために必要なアクセス許可)。
• SecurityPermission  (デリゲートのインスタンスの作成時にアンマネージ コードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
• ReflectionPermission  (すべての型のメンバに対して操作を呼び出すために必要なアクセス許可)。ReflectionPermissionFlag.MemberAccess (関連する列挙体)

プラットフォーム

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、1.1、1.0

参照

関連項目
AppDomain クラス
AppDomain メンバ
System 名前空間
Activator.CreateInstance

AppDomain.CreateInstance メソッド (String, String)

指定したアセンブリで定義されている、指定した型の新しいインスタンスを作成します。

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

Visual Basic (宣言)

Public Function CreateInstance ( _
    assemblyName As String, _
    typeName As String _
) As ObjectHandle

Visual Basic (使用法)

Dim instance As AppDomain
Dim assemblyName As String
Dim typeName As String
Dim returnValue As ObjectHandle

returnValue = instance.CreateInstance(assemblyName, typeName)

C#

public ObjectHandle CreateInstance (
    string assemblyName,
    string typeName
)

C++

public:
virtual ObjectHandle^ CreateInstance (
    String^ assemblyName, 
    String^ typeName
) sealed

J#

public final ObjectHandle CreateInstance (
    String assemblyName, 
    String typeName
)

JScript

public final function CreateInstance (
    assemblyName : String, 
    typeName : String
) : ObjectHandle

パラメータ

assemblyName

アセンブリの表示名。詳細については、Assembly.FullName のトピックを参照してください。

typeName

要求する型の完全修飾名。アセンブリは指定せずに、名前空間だけを指定します。この名前は、Type.FullName プロパティによって返されます。

戻り値
typeName で指定した新しいインスタンスのラッパーであるオブジェクト。実際のオブジェクトにアクセスするには、戻り値のラップを解除する必要があります。

例外

例外の種類	条件
AppDomainUnloadedException	操作が、アンロードされたアプリケーション ドメインで試行されています。
ArgumentNullException	assemblyName または typeName が null 参照 (Visual Basic では Nothing) です。
BadImageFormatException	assemblyName が有効なアセンブリではありません。
FileLoadException	1 つのアセンブリまたはモジュールが 2 つの異なる証拠を使用して 2 回読み込まれました。
FileNotFoundException	assemblyName は見つかりませんでした。
MethodAccessException	呼び出し元に、このコンストラクタを呼び出すためのアクセス許可がありません。
MissingMethodException	一致するパブリック コンストラクタが見つかりませんでした。
TypeLoadException	assemblyName で、typename が見つかりませんでした。

解説

このメソッドは、typeName の既定のコンストラクタを呼び出します。

assemblyName の書式については、AssemblyName のトピックを参照してください。

現在のアプリケーション ドメインではない対象のアプリケーション ドメインで CreateInstance を呼び出そうとすると、対象のアプリケーション ドメインにアセンブリが正常に読み込まれます。Assembly は MarshalByRefObject ではないため、読み込まれたアセンブリに対する Assembly をこのメソッドで現在のアプリケーション ドメインに戻そうとした場合、共通言語ランタイムはアセンブリを現在のアプリケーション ドメインに読み込もうとしますが、結果的には読み込みに失敗することがあります。現在のアプリケーション ドメインと、最初にアセンブリが読み込まれたアプリケーション ドメインのパスの設定が異なる場合には、それぞれのアプリケーション ドメインに読み込まれたアセンブリは異なる場合があります。

.NET Framework のセキュリティ

• FileIOPermission  (ファイルまたはディレクトリから読み取るためのアクセス許可、またはパス自体の情報に対するアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.PathDiscovery (関連する列挙体)
• WebPermission  (アセンブリがローカルにない場合にアセンブリの場所にアクセスするために必要なアクセス許可)。
• SecurityPermission  (デリゲートのインスタンスの作成時にアンマネージ コードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

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、1.1、1.0

参照

関連項目
AppDomain クラス
AppDomain メンバ
System 名前空間
Activator.CreateInstance

AppDomain.CreateInstance メソッド

指定したアセンブリで定義されている、指定した型の新しいインスタンスを作成します。
オーバーロードの一覧

名前	説明
AppDomain.CreateInstance (String, String)	指定したアセンブリで定義されている、指定した型の新しいインスタンスを作成します。
AppDomain.CreateInstance (String, String, Object[])	指定したアセンブリで定義されている、指定した型の新しいインスタンスを作成します。アクティベーション属性の配列をパラメータで指定します。
AppDomain.CreateInstance (String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)	指定したアセンブリで定義されている、指定した型の新しいインスタンスを作成します。バインダ、バインディング フラグ、コンストラクタ引数、引数を解釈するために使用するカルチャ固有の情報、アクティベーション属性、型を作成するために必要な承認情報をパラメータで指定します。

参照

関連項目

AppDomain クラス
AppDomain メンバ
System 名前空間
Activator.CreateInstance

_AppDomain.CreateInstance メソッド

COM オブジェクトに、System.AppDomain.CreateInstance メソッドへのバージョンに依存しないアクセスが用意されています。
オーバーロードの一覧

名前	説明
_AppDomain.CreateInstance (String, String)	COM オブジェクトに、AppDomain.CreateInstance メソッドへのバージョンに依存しないアクセスが用意されています。
_AppDomain.CreateInstance (String, String, Object[])	COM オブジェクトに、AppDomain.CreateInstance(String,String,Object[]) メソッド オーバーロードへのバージョンに依存しないアクセスが用意されています。
_AppDomain.CreateInstance (String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)	COM オブジェクトに、AppDomain.CreateInstance(String,String,Boolean,BindingFlags,Binder,Object[],CultureInfo,Object[],Evidence) メソッド オーバーロードへのバージョンに依存しないアクセスが用意されています。

参照

関連項目

_AppDomain インターフェイス
_AppDomain メンバ
System 名前空間