AppDomain.CreateComInstanceFromとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

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

指定した COM 型の新しいインスタンスを作成します。パラメータには、型を含んでいるアセンブリのファイルの名前および型の名前を指定します。

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

Visual Basic (宣言)

Public Function CreateComInstanceFrom ( _
    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.CreateComInstanceFrom(assemblyName, typeName)

public ObjectHandle CreateComInstanceFrom (
    string assemblyName,
    string typeName
)

C++

public:
ObjectHandle^ CreateComInstanceFrom (
    String^ assemblyName, 
    String^ typeName
)

public ObjectHandle CreateComInstanceFrom (
    String assemblyName, 
    String typeName
)

JScript

public function CreateComInstanceFrom (
    assemblyName : String, 
    typeName : String
) : ObjectHandle

パラメータ

assemblyName: 要求された型を定義するアセンブリが格納されているファイルの名前。

typeName: 要求された型の名前。

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

例外

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

解説

このメソッドを使用すると、型をローカルに読み込まなくても、オブジェクトをリモートで作成できます。

実際のオブジェクトにアクセスするには、戻り値のラップを解除する必要があります。

このメソッドで COM 型のインスタンスを作成するには、値を true に設定した System.Runtime.InteropServices.ComVisibleAttribute 属性をその COM 型に明示的にまたは既定で適用する必要があります。それ以外の場合は TypeLoadException がスローされます。

使用例

サンプルを次に示します。

Visual Basic

Imports System
Imports System.Reflection
Imports System.Runtime.InteropServices

<ComVisible(True)> _
Class MyComVisibleType

   Public Sub New()
      Console.WriteLine("MyComVisibleType instantiated!")
   End Sub 'New

End Class 'MyComVisibleType

<ComVisible(False)> _
Class MyComNonVisibleType

   Public Sub New()
      Console.WriteLine("MyComNonVisibleType instantiated!")
   End Sub 'New

End Class 'MyComNonVisibleType

Module Test

   Sub Main()
      CreateComInstance("MyComNonVisibleType")   '
 Fail!
      CreateComInstance("MyComVisibleType")      '
 OK!
   End Sub 'Main

   Sub CreateComInstance(typeName As String)
      Try
         Dim currentDomain As AppDomain = AppDomain.CurrentDomain
         Dim assemblyName As String
 = currentDomain.FriendlyName
         currentDomain.CreateComInstanceFrom(assemblyName, typeName)
      Catch e As Exception
         Console.WriteLine(e.Message)
      End Try
   End Sub 'CreateComInstance

End Module 'Test

using System;
using System.Reflection;
using System.Runtime.InteropServices;

[ComVisible(true)]
class MyComVisibleType {
   public MyComVisibleType() {
      Console.WriteLine("MyComVisibleType instantiated!");
   }
}

[ComVisible(false)]
class MyComNonVisibleType {
   public MyComNonVisibleType() {
      Console.WriteLine("MyComNonVisibleType instantiated!");
   }
}

class Test {
   public static void Main()
 {
      CreateComInstance("MyComNonVisibleType");   // Fail!
      CreateComInstance("MyComVisibleType");      // OK!
   }
   
   static void CreateComInstance(string
 typeName) {
      try {
         AppDomain currentDomain = AppDomain.CurrentDomain;
         string assemblyName = currentDomain.FriendlyName;
         currentDomain.CreateComInstanceFrom(assemblyName, typeName);
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }
}

C++

using namespace System;
using namespace System::Reflection;
using namespace System::Runtime::InteropServices;

[ComVisible(true)]
public ref class MyComVisibleType
{
public:
   MyComVisibleType()
   {
      Console::WriteLine( "MyComVisibleType instantiated!" );
   }

};


[ComVisible(false)]
public ref class MyComNonVisibleType
{
public:
   MyComNonVisibleType()
   {
      Console::WriteLine( "MyComNonVisibleType instantiated!" );
   }

};

void CreateComInstance( String^ typeName )
{
   try
   {
      AppDomain^ currentDomain = AppDomain::CurrentDomain;
      String^ assemblyName = currentDomain->FriendlyName;
      currentDomain->CreateComInstanceFrom( assemblyName, typeName );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e->Message );
   }

}

int main()
{
   CreateComInstance( "MyComNonVisibleType" ); // Fail!
   CreateComInstance( "MyComVisibleType" ); // OK!
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

AppDomain.CreateComInstanceFrom メソッド (String, String, Byte[], AssemblyHashAlgorithm)