Assembly.CreateInstance メソッド

リファレンス

定義

名前空間:: System.Reflection

アセンブリ:: System.Runtime.dll

アセンブリ:: System.Reflection.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

このアセンブリから型を検索し、システムアクティベーターを使用してこの型のインスタンスを作成します。

オーバーロード

CreateInstance(String)	大文字小文字を区別する検索を使用してこのアセンブリから指定された型を検索し、システムアクティベーターを使用してこの型のインスタンスを作成します。
CreateInstance(String, Boolean)	オプションの大文字小文字を区別する検索を使用してこのアセンブリから指定された型を検索し、システムアクティベーターを使用してこの型のインスタンスを作成します。
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	オプションの大文字小文字を区別する検索を使用して、このアセンブリから指定された型を検索し、システムアクティベーターを使用してこの型のインスタンスを作成し、指定されたカルチャ設定、引数、バインディング属性、およびアクティベーション属性を設定します。

CreateInstance(String)

ソース:: Assembly.cs

ソース:: Assembly.cs

ソース:: Assembly.cs

大文字小文字を区別する検索を使用してこのアセンブリから指定された型を検索し、システムアクティベーターを使用してこの型のインスタンスを作成します。

public:
 System::Object ^ CreateInstance(System::String ^ typeName);

public:
 virtual System::Object ^ CreateInstance(System::String ^ typeName);

public object? CreateInstance (string typeName);

public object CreateInstance (string typeName);

member this.CreateInstance : string -> obj

abstract member CreateInstance : string -> obj
override this.CreateInstance : string -> obj

Public Function CreateInstance (typeName As String) As Object

パラメーター

typeName: String

検索対象の型の FullName。

戻り値

Object

パラメーターのないコンストラクターが使用されて作成された指定した型のインスタンス。typeName が見つからない場合は、null。型は、既定のバインダーを使用して解決されます。カルチャまたはアクティベーション属性は指定せず、BindingFlags を Public または Instance に設定します。

実装

CreateInstance(String)

例外

ArgumentException

typeName は空の文字列 ("") または null 文字で始まる文字列です。

- または -

現在のアセンブリは、リフレクションのみのコンテキストに読み込まれました。

ArgumentNullException

typeName が nullです。

MissingMethodException

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

FileNotFoundException

typeName には見つからなかった依存アセンブリが必要です。

FileLoadException

typeName には、見つかったものの読み込めなかった依存アセンブリが必要です。

- または -

現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、typeName には事前に読み込まれていない依存アセンブリが必要です。

BadImageFormatException

typeName には依存アセンブリが必要ですが、ファイルは現在読み込まれているランタイムの有効なアセンブリではありません。

例

次の例では、クラスを Person 定義し、メソッドを CreateInstance(String) 呼び出してインスタンス化します。

using System;
using System.Reflection;
using Contoso.Libraries;

namespace Contoso.Libraries
{
   public class Person
   {
      private string _name;

      public Person()
      { }

      public Person(string name)
      {
         this._name = name;
      }

      public string Name
      { get { return this._name; }
        set { this._name = value; } }

      public override string ToString()
      {
         return this._name;
      }
   }
}

public class Example
{
   public static void Main()
   {
      Assembly assem = typeof(Person).Assembly;
      Person p = (Person) assem.CreateInstance("Contoso.Libraries.Person");
      if (! (p == null)) {
         p.Name = "John";
         Console.WriteLine("Instantiated a {0} object whose value is '{1}'",
                           p.GetType().Name, p);
      }
      else {
         Console.WriteLine("Unable to instantiate a Person object.");
      }
   }
}
// The example displays the following output:
//        Instantiated a Person object whose value is 'John'

Imports System.Reflection
Imports Contoso.Libraries

Namespace Contoso.Libraries
   Public Class Person
      Private _name As String 
   
      Public Sub New()
      End Sub 
   
      Public Sub New(name As String)
         Me._name = name
      End Sub 
   
      Public Property Name As String 
         Get 
            Return Me._name
         End Get 
         Set 
            Me._name = value
         End Set 
      End Property 
   
      Public Overrides Function ToString() As String 
         Return Me._name
      End Function 
   End Class
End Namespace 

Module Example
   Public Sub Main()
      Dim assem As Assembly = GetType(Person).Assembly
      Dim p As Person = CType(assem.CreateInstance("Contoso.Libraries.Person"),
                              Person)
      If p IsNot Nothing Then
         p.Name = "John"
         Console.WriteLine("Instantiated a {0} object whose value is '{1}'",
                           p.GetType().Name, p)
      Else
         Console.WriteLine("Unable to instantiate a Person object.")
      End If   
   End Sub
End Module
' The example displays the following output:
'       Instantiated a Person object whose value is 'John'

注釈

ランタイムがインスタンス内でAssembly見typeNameつからない場合は、例外をnullスローする代わりにを返します。これは、次の場合に発生する可能性があります。

型の完全修飾名を指定していません。
完全修飾型名を指定しましたが、その大文字と小文字が型 Type.FullName のプロパティの大文字と小文字が一致しません。の大文字と小文字を区別せずに型のフルネームと比較typeNameするには、オーバーロードをCreateInstance(String, Boolean)呼び出し、引数に ignoreCase を指定trueします。
型は現在 Assembly のインスタンスに存在しません。

適用対象

CreateInstance(String, Boolean)

ソース:: Assembly.cs

ソース:: Assembly.cs

ソース:: Assembly.cs

オプションの大文字小文字を区別する検索を使用してこのアセンブリから指定された型を検索し、システムアクティベーターを使用してこの型のインスタンスを作成します。

public:
 System::Object ^ CreateInstance(System::String ^ typeName, bool ignoreCase);

public:
 virtual System::Object ^ CreateInstance(System::String ^ typeName, bool ignoreCase);

public object? CreateInstance (string typeName, bool ignoreCase);

public object CreateInstance (string typeName, bool ignoreCase);

member this.CreateInstance : string * bool -> obj

abstract member CreateInstance : string * bool -> obj
override this.CreateInstance : string * bool -> obj

Public Function CreateInstance (typeName As String, ignoreCase As Boolean) As Object

パラメーター

typeName: String

検索対象の型の FullName。

ignoreCase: Boolean

型名の大文字と小文字の違いを無視する場合は true。それ以外の場合は false。

戻り値

Object

実装

CreateInstance(String, Boolean)

例外

ArgumentException

typeName は空の文字列 ("") または null 文字で始まる文字列です。

- または -

現在のアセンブリは、リフレクションのみのコンテキストに読み込まれました。

MissingMethodException

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

ArgumentNullException

typeName が nullです。

FileNotFoundException

typeName には見つからなかった依存アセンブリが必要です。

FileLoadException

typeName には、見つかったものの読み込めなかった依存アセンブリが必要です。

- または -

現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、typeName には事前に読み込まれていない依存アセンブリが必要です。

BadImageFormatException

typeName には依存アセンブリが必要ですが、ファイルは現在読み込まれているランタイムの有効なアセンブリではありません。

例

次の例では、Person クラスを定義しています。その後、メソッドをCreateInstance(String)呼び出してインスタンス化しますが、引数の大文字と小文字が型FullNameのtypeNameプロパティと一致しないため、メソッドはを返しますnull。この例では、同じ文字列をオーバーロードに CreateInstance(String, Boolean) 渡し、比較で大文字と小文字を区別しないことを指定すると、 Person クラスが見つかり Person 、オブジェクトが正常にインスタンス化されます。

using System;
using System.Reflection;
using Contoso.Libraries;

namespace Contoso.Libraries
{
   public class Person
   {
      private string _name;

      public Person()
      { }

      public Person(string name)
      {
         this._name = name;
      }

      public string Name
      { get { return this._name; }
        set { this._name = value; } }

      public override string ToString()
      {
         return this._name;
      }
   }
}

public class Example
{
   public static void Main()
   {
      String fullName = "contoso.libraries.person";
      Assembly assem = typeof(Person).Assembly;
      Person p = (Person) assem.CreateInstance(fullName);
      if (! (p == null)) {
         p.Name = "John";
         Console.WriteLine("Instantiated a {0} object whose value is '{1}'",
                           p.GetType().Name, p);
      }
      else {
         Console.WriteLine("Unable to instantiate a Person object " +
                           "with Assembly.CreateInstance(String)");
         // Try case-insensitive type name comparison.
         p = (Person) assem.CreateInstance(fullName, true);
         if (! (p == null)) {
            p.Name = "John";
            Console.WriteLine("Instantiated a {0} object whose value is '{1}'",
                              p.GetType().Name, p);
         }
         else {
            Console.WriteLine("Unable to instantiate a {0} object.",
                              fullName);
         }
      }
   }
}
// The example displays the following output:
//    Unable to instantiate a Person object with Assembly.CreateInstance(String)
//    Instantiated a Person object whose value is 'John'

Imports System.Reflection
Imports Contoso.Libraries

Namespace Contoso.Libraries
   Public Class Person
      Private _name As String 
   
      Public Sub New()
      End Sub 
   
      Public Sub New(name As String)
         Me._name = name
      End Sub 
   
      Public Property Name As String 
         Get 
            Return Me._name
         End Get 
         Set 
            Me._name = value
         End Set 
      End Property 
   
      Public Overrides Function ToString() As String 
         Return Me._name
      End Function 
   End Class
End Namespace 

Module Example
   Public Sub Main()
      Dim fullName As String = "contoso.libraries.person"
      Dim assem As Assembly = GetType(Person).Assembly
      Dim p As Person = CType(assem.CreateInstance(fullName),
                              Person)
      If p IsNot Nothing Then
         p.Name = "John"
         Console.WriteLine("Instantiated a {0} object whose value is '{1}'",
                           p.GetType().Name, p)
      Else
         Console.WriteLine("Unable to instantiate a Person object" +
                           "with Assembly.CreateInstance(String)")
         ' Try case-insensitive type name comparison.
         p = CType(assem.CreateInstance(fullName, true), Person)
         If p IsNot Nothing Then 
            p.Name = "John"
            Console.WriteLine("Instantiated a {0} object whose value is '{1}'",
                              p.GetType().Name, p)
         Else 
            Console.WriteLine("Unable to instantiate a {0} object.", 
                              fullName)
         End If   
      End If   
   End Sub
End Module
' The example displays the following output:
'    Unable to instantiate a Person object with Assembly.CreateInstance(String)
'    Instantiated a Person object whose value is 'John'

注釈

型の完全修飾名を指定していません。
型は現在 Assembly のインスタンスに存在しません。

適用対象

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

ソース:: Assembly.cs

ソース:: Assembly.cs

ソース:: Assembly.cs

オプションの大文字小文字を区別する検索を使用して、このアセンブリから指定された型を検索し、システムアクティベーターを使用してこの型のインスタンスを作成し、指定されたカルチャ設定、引数、バインディング属性、およびアクティベーション属性を設定します。

public:
 virtual System::Object ^ CreateInstance(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 virtual object? CreateInstance (string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object[]? args, System.Globalization.CultureInfo? culture, object[]? activationAttributes);

public virtual object CreateInstance (string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

public object CreateInstance (string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

abstract member CreateInstance : string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> obj
override this.CreateInstance : string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> obj

Public Overridable Function CreateInstance (typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As Object

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

パラメーター

typeName: String

検索対象の型の FullName。

ignoreCase: Boolean

型名の大文字と小文字の違いを無視する場合は true。それ以外の場合は false。

bindingAttr: BindingFlags

検索の実行方法に影響を与えるビットマスク。値は、BindingFlags のビットフラグの組み合わせです。

binder: Binder

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

args: Object[]

コンストラクターに渡す引数を格納する配列。この引数の配列は、呼び出すコンストラクターのパラメーターと、数、順序、および型が同じでなければなりません。パラメーターなしのコンストラクターを使用する場合は、args を空の配列または null にする必要があります。

culture: CultureInfo

型の強制変換を制御するために使用する CultureInfo のインスタンス。 null の場合は、現在のスレッドの CultureInfo が使用されます。 (これは、たとえば、1000 を表す文字列を Double 値に変換する場合に必要です。これは、カルチャによって 1000 の表記が異なるためです。)

activationAttributes: Object[]

アクティべーションに参加できる 1 つ以上の属性の配列。通常、リモートオブジェクトをアクティブ化するために必要な URL を指定する 1 つの UrlAttribute オブジェクトを含む配列。このパラメーターは、クライアント側でアクティブ化されるオブジェクトに関連しています。クライアントアクティベーションは、下位互換性のために残されているレガシテクノロジです。新規の開発には使用しないでください。分散アプリケーションは、代わりに Windows Communication Foundation (WCF) を使用する必要があります。

戻り値

Object

指定した型のインスタンス。typeName が見つからない場合は、null。指定された引数は、型を解決するため、およびインスタンスの作成に使用されるコンストラクターをバインドするために使用されます。

実装

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

例外

ArgumentException

typeName は空の文字列 ("") または null 文字で始まる文字列です。

- または -

現在のアセンブリは、リフレクションのみのコンテキストに読み込まれました。

ArgumentNullException

typeName が nullです。

MissingMethodException

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

NotSupportedException

空でないアクティベーション属性の配列は、 MarshalByRefObjectから継承されていない型に渡されます。

FileNotFoundException

typeName には見つからなかった依存アセンブリが必要です。

FileLoadException

typeName には、見つかったものの読み込めなかった依存アセンブリが必要です。

- または -

現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、typeName には事前に読み込まれていない依存アセンブリが必要です。

BadImageFormatException

typeName には依存アセンブリが必要ですが、ファイルは現在読み込まれているランタイムの有効なアセンブリではありません。

適用対象

次の方法で共有

Assembly.CreateInstance メソッド

定義

オーバーロード

CreateInstance(String)

パラメーター

戻り値

実装

例外

例

注釈

適用対象

CreateInstance(String, Boolean)

パラメーター

戻り値

実装

例外

例

注釈

適用対象

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

パラメーター

戻り値

実装

例外

適用対象

その他のリソース