Activator.CreateInstanceFrom メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

名前を指定したアセンブリ ファイルと、指定したパラメーターに最も一致するコンストラクターを使用して、名前を指定した型のインスタンスを作成します。

オーバーロード

CreateInstanceFrom(String, String, Object[])	名前を指定したアセンブリ ファイルと、パラメーターなしのコンストラクターを使用して、名前を指定した型のインスタンスを作成します。
CreateInstanceFrom(String, String)	名前を指定したアセンブリ ファイルと、パラメーターなしのコンストラクターを使用して、名前を指定した型のインスタンスを作成します。
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	名前を指定したアセンブリ ファイルと、指定したパラメーターに最も一致するコンストラクターを使用して、名前を指定した型のインスタンスを作成します。

CreateInstanceFrom(String, String, Object[])

Source:

Activator.cs

名前を指定したアセンブリ ファイルと、パラメーターなしのコンストラクターを使用して、名前を指定した型のインスタンスを作成します。

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, object?[]? activationAttributes);

static member CreateInstanceFrom : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, activationAttributes As Object()) As ObjectHandle

パラメーター

assemblyFile

String

typeName という名前の型をシークする場所となるアセンブリが含まれているファイルの名前。

typeName

String

インスタンスを作成する型の名前。

activationAttributes

Object[]

アクティべーションに参加できる 1 つ以上の属性の配列。 これは、通常、リモート オブジェクトをアクティブ化するために必要な URL を指定する 1 つの UrlAttribute オブジェクトを含む配列です。

このパラメーターは、クライアント側でアクティブ化されるオブジェクトに関連しています。 クライアント アクティベーションは、下位互換性のために残されているレガシ テクノロジです。新規の開発には使用しないでください。 分散アプリケーションは、代わりに Windows Communication Foundation (WCF) を使用する必要があります。

戻り値

ObjectHandle

新しく作成されたオブジェクトまたはnullNullable<T>インスタンスにアクセスするためにラップ解除する必要があるハンドル。

例外

ArgumentNullException

typeName が nullです。

MissingMethodException

一致するパブリック コンストラクターが見つかりませんでした。

TypeLoadException

typename が assemblyFile で見つかりませんでした。

FileNotFoundException

assemblyFile が見つかりませんでした。

MethodAccessException

呼び出し元には、このコンストラクターを呼び出すアクセス許可がありません。

MemberAccessException

抽象クラスのインスタンスを作成することができないか、またはこのメンバーは遅延バインド メカニズムで呼び出されました。

TargetInvocationException

リフレクションを通じて呼び出されたコンストラクターが、例外をスローしました。

NotSupportedException

activationAttributes が空の配列ではないか、作成される型が MarshalByRefObject から派生したものではありません。

SecurityException

呼び出し元に、必要な FileIOPermission がありません。

BadImageFormatException

assemblyFile は有効なアセンブリではありません。

- または -

共通言語ランタイム (CLR) バージョン 2.0 以降が現在読み込まれており、assemblyName は現在読み込まれているバージョンより新しいバージョンの CLR 用にコンパイルされました。 .NET Framework のバージョン 2.0、3.0、3.5 はすべて、CLR バージョン 2.0 を使うことにご注意ください。

注釈

戻り値の ObjectHandle.Unwrap ラップを解除するには、 メソッドを使用します。

呼び出されたメソッドによってスローされるその他の例外については、 メソッドと CreateInstance メソッドの例外に関するセクションをAssembly.LoadFrom参照してください。

CreateInstanceFrom(String, String)

Source:

Activator.cs

名前を指定したアセンブリ ファイルと、パラメーターなしのコンストラクターを使用して、名前を指定した型のインスタンスを作成します。

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName);

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName);

static member CreateInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String) As ObjectHandle

パラメーター

assemblyFile

String

typeName という名前の型をシークする場所となるアセンブリが含まれているファイルの名前。

typeName

String

インスタンスを作成する型の名前。

戻り値

ObjectHandle

新しく作成されたオブジェクトまたはnullNullable<T>インスタンスにアクセスするためにラップ解除する必要があるハンドル。

例外

ArgumentNullException

typeName が nullです。

MissingMethodException

一致するパブリック コンストラクターが見つかりませんでした。

TypeLoadException

typename が assemblyFile で見つかりませんでした。

FileNotFoundException

assemblyFile が見つかりませんでした。

MethodAccessException

呼び出し元には、このコンストラクターを呼び出すアクセス許可がありません。

MemberAccessException

抽象クラスのインスタンスを作成することができないか、またはこのメンバーは遅延バインド メカニズムで呼び出されました。

TargetInvocationException

リフレクションを通じて呼び出されたコンストラクターが、例外をスローしました。

SecurityException

呼び出し元に、必要な FileIOPermission がありません。

BadImageFormatException

assemblyFile は有効なアセンブリではありません。

- または -

共通言語ランタイム (CLR) バージョン 2.0 以降が現在読み込まれており、assemblyName は現在読み込まれているバージョンより新しいバージョンの CLR 用にコンパイルされました。 .NET Framework のバージョン 2.0、3.0、3.5 はすべて、CLR バージョン 2.0 を使うことにご注意ください。

例

次のコード例は、 メソッドを呼び出す方法を CreateInstanceFrom 示しています。 このコード例は、Activator クラスのために提供されている大規模な例の一部です。

// Create an instance of the SomeType class that is defined in this 
// assembly.
System::Runtime::Remoting::ObjectHandle^ oh = 
    Activator::CreateInstanceFrom(Assembly::GetEntryAssembly()->CodeBase, 
                                  SomeType::typeid->FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType^ st = (SomeType^) oh->Unwrap();

st->DoSomething(5);

// Create an instance of the SomeType class that is defined in this
// assembly.
System.Runtime.Remoting.ObjectHandle oh =
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase,
                                 typeof(SomeType).FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType st = (SomeType) oh.Unwrap();

st.DoSomething(5);

// Create an instance of the SomeType class that is defined in this assembly.
let oh = 
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().Location, typeof<SomeType>.FullName)

// Call an instance method defined by the SomeType type using this object.
let st = oh.Unwrap() :?> SomeType

st.DoSomething 5

' Create an instance of the SomeType class that is defined in this assembly.
Dim oh As System.Runtime.Remoting.ObjectHandle = _
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase, _
                                 GetType(SomeType).FullName)

' Call an instance method defined by the SomeType type using this object.
Dim st As SomeType = CType(oh.Unwrap(), SomeType)

st.DoSomething(5)

注釈

戻り値の ObjectHandle.Unwrap ラップを解除するには、 メソッドを使用します。

呼び出されたメソッドによってスローされるその他の例外については、 メソッドと CreateInstance メソッドの例外に関するセクションをAssembly.LoadFrom参照してください。

CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Source:

Activator.cs

名前を指定したアセンブリ ファイルと、指定したパラメーターに最も一致するコンストラクターを使用して、名前を指定した型のインスタンスを作成します。

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As ObjectHandle

パラメーター

assemblyFile

String

typeName という名前の型をシークする場所となるアセンブリが含まれているファイルの名前。

typeName

String

インスタンスを作成する型の名前。

ignoreCase

Boolean

typeName の検索で大文字と小文字を区別しない場合は true。検索で大文字と小文字を区別する場合は false。

bindingAttr

BindingFlags

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

binder

Binder

bindingAttr および args を使用して typeName コンストラクターをシークおよび識別するオブジェクト。 binder が null の場合は、既定のバインダーが使用されます。

args

Object[]

数、順序、および型が、呼び出すコンストラクターのパラメーターと一致する引数の配列です。 args が空の配列または null である場合は、パラメーターを受け取らないコンストラクター (パラメーターなしのコンストラクター) が呼び出されます。

culture

CultureInfo

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

activationAttributes

Object[]

アクティべーションに参加できる 1 つ以上の属性の配列。 これは、通常、リモート オブジェクトをアクティブ化するために必要な URL を指定する 1 つの UrlAttribute オブジェクトを含む配列です。

このパラメーターは、クライアント側でアクティブ化されるオブジェクトに関連しています。 クライアント アクティベーションは、下位互換性のために残されているレガシ テクノロジです。新規の開発には使用しないでください。 分散アプリケーションは、代わりに Windows Communication Foundation (WCF) を使用する必要があります。

戻り値

ObjectHandle

新しく作成されたオブジェクトnullNullable<T>またはインスタンスにアクセスするためにラップ解除する必要があるハンドル。

例外

ArgumentNullException

typeName が nullです。

MissingMethodException

一致するコンストラクターが見つかりませんでした。

TypeLoadException

typename が assemblyFile で見つかりませんでした。

FileNotFoundException

assemblyFile が見つかりませんでした。

MethodAccessException

呼び出し元には、このコンストラクターを呼び出すアクセス許可がありません。

MemberAccessException

抽象クラスのインスタンスを作成することができないか、またはこのメンバーは遅延バインド メカニズムで呼び出されました。

TargetInvocationException

リフレクションを通じて呼び出されたコンストラクターが、例外をスローしました。

SecurityException

呼び出し元に、必要な FileIOPermission がありません。

NotSupportedException

activationAttributes が空の配列ではないか、作成される型が MarshalByRefObject から派生したものではありません。

BadImageFormatException

assemblyFile は有効なアセンブリではありません。

- または -

共通言語ランタイム (CLR) バージョン 2.0 以降が現在読み込まれており、assemblyName は現在読み込まれているバージョンより新しいバージョンの CLR 用にコンパイルされました。 .NET Framework のバージョン 2.0、3.0、3.5 はすべて、CLR バージョン 2.0 を使うことにご注意ください。

注釈

戻り値の ObjectHandle.Unwrap ラップを解除するには、 メソッドを使用します。

呼び出されたメソッドによってスローされる可能性があるその他の例外については、 メソッドと CreateInstance メソッドの例外に関するセクションをAssembly.LoadFrom参照してください。