AppDomain.CreateComInstanceFrom 메서드

정의

지정한 COM 형식의 새 인스턴스를 만듭니다.Creates a new instance of a specified COM type.

오버로드

CreateComInstanceFrom(String, String)

지정한 COM 형식의 새 인스턴스를 만듭니다.Creates a new instance of a specified COM type. 매개 변수는 형식 및 형식 이름을 포함하는 어셈블리가 포함된 파일 이름을 지정합니다.Parameters specify the name of a file that contains an assembly containing the type and the name of the type.

CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)

지정한 COM 형식의 새 인스턴스를 만듭니다.Creates a new instance of a specified COM type. 매개 변수는 형식 및 형식 이름을 포함하는 어셈블리가 포함된 파일 이름을 지정합니다.Parameters specify the name of a file that contains an assembly containing the type and the name of the type.

CreateComInstanceFrom(String, String)

지정한 COM 형식의 새 인스턴스를 만듭니다.Creates a new instance of a specified COM type. 매개 변수는 형식 및 형식 이름을 포함하는 어셈블리가 포함된 파일 이름을 지정합니다.Parameters specify the name of a file that contains an assembly containing the type and the name of the type.

public:
 System::Runtime::Remoting::ObjectHandle ^ CreateComInstanceFrom(System::String ^ assemblyName, System::String ^ typeName);
public System.Runtime.Remoting.ObjectHandle CreateComInstanceFrom (string assemblyName, string typeName);
member this.CreateComInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle
Public Function CreateComInstanceFrom (assemblyName As String, typeName As String) As ObjectHandle

매개 변수

assemblyName
String

요청된 형식을 정의하는 어셈블리가 포함된 파일 이름입니다.The name of a file containing an assembly that defines the requested type.

typeName
String

요청된 형식의 이름입니다.The name of the requested type.

반환

typeName에서 지정한 새 인스턴스의 래퍼인 개체입니다.An object that is a wrapper for the new instance specified by typeName. 실제 개체에 액세스하려면 반환 값은 래핑되지 않아야 합니다.The return value needs to be unwrapped to access the real object.

예외

assemblyName 또는 typeNamenull인 경우assemblyName or typeName is null.

형식을 로드할 수 없는 경우.The type cannot be loaded.

언로드된 애플리케이션 도메인에서 작업이 시도됩니다.The operation is attempted on an unloaded application domain.

매개 변수가 없는 public 생성자를 찾지 못한 경우No public parameterless constructor was found.

assemblyName가 없는 경우assemblyName is not found.

typeName는 추상 클래스입니다.typeName is an abstract class.

또는-or- 이 멤버가 런타임에 바인딩된 메커니즘을 사용하여 호출되었습니다.This member was invoked with a late-binding mechanism.

호출자가 MarshalByRefObject에서 상속되지 않는 개체에 대한 활성화 특성을 제공할 수 없습니다.The caller cannot provide activation attributes for an object that does not inherit from MarshalByRefObject.

assemblyName가 빈 문자열("")인 경우assemblyName is an empty string ("").

assemblyName는 유효한 어셈블리가 아닙니다.assemblyName is not a valid assembly.

어셈블리 또는 모듈이 서로 다른 두 증명 정보로 두 번 로드되었습니다.An assembly or module was loaded twice with two different evidences.

참조되는 COM 개체가 null인 경우The COM object that is being referred to is null.

예제

다음 샘플에서는The following sample demonstrates

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!
}

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);
      }
   }
}
Imports System.Reflection
Imports System.Runtime.InteropServices

<ComVisible(True)> _
Class MyComVisibleType

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

End Class

<ComVisible(False)> _
Class MyComNonVisibleType

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

End Class

Module Test

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

   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

End Module 'Test

설명

이 메서드를 사용 하 여 형식을 로컬로 로드 하지 않고도 원격으로 개체를 만들 수 있습니다.Use this method to create objects remotely without having to load the type locally.

실제 개체에 액세스 하려면 반환 값을 래핑 해제 해야 합니다.The return value must to be unwrapped to access the real object.

값이 trueSystem.Runtime.InteropServices.ComVisibleAttribute 특성은 해당 형식의 인스턴스를 만들기 위해이 메서드에 대해 명시적으로 또는 기본적으로 COM 형식에 적용 되어야 합니다. 그렇지 않으면 TypeLoadException이 throw 됩니다.A System.Runtime.InteropServices.ComVisibleAttribute attribute with a value of true must be applied either explicitly or by default to the COM type for this method to create an instance of that type; otherwise, TypeLoadException is thrown.

보안

FileIOPermissionAccess
어셈블리 매니페스트가 포함 된 파일을 읽을 수 있습니다.for the ability to read the file containing the assembly manifest. 연결 된 열거형: ReadAssociated enumeration: Read

WebPermission
어셈블리가 로컬이 아닌 경우 어셈블리의 위치에 액세스할 수 있습니다.for the ability to access the location of the assembly if the assembly is not local.

추가 정보

CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)

지정한 COM 형식의 새 인스턴스를 만듭니다.Creates a new instance of a specified COM type. 매개 변수는 형식 및 형식 이름을 포함하는 어셈블리가 포함된 파일 이름을 지정합니다.Parameters specify the name of a file that contains an assembly containing the type and the name of the type.

public:
 System::Runtime::Remoting::ObjectHandle ^ CreateComInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);
public System.Runtime.Remoting.ObjectHandle CreateComInstanceFrom (string assemblyFile, string typeName, byte[] hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);
member this.CreateComInstanceFrom : string * string * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Runtime.Remoting.ObjectHandle
Public Function CreateComInstanceFrom (assemblyFile As String, typeName As String, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As ObjectHandle

매개 변수

assemblyFile
String

요청된 형식을 정의하는 어셈블리가 포함된 파일 이름입니다.The name of a file containing an assembly that defines the requested type.

typeName
String

요청된 형식의 이름입니다.The name of the requested type.

hashValue
Byte[]

계산된 해시 코드의 값을 나타냅니다.Represents the value of the computed hash code.

hashAlgorithm
AssemblyHashAlgorithm

어셈블리 매니페스트에 사용되는 해시 알고리즘을 나타냅니다.Represents the hash algorithm used by the assembly manifest.

반환

typeName에서 지정한 새 인스턴스의 래퍼인 개체입니다.An object that is a wrapper for the new instance specified by typeName. 실제 개체에 액세스하려면 반환 값은 래핑되지 않아야 합니다.The return value needs to be unwrapped to access the real object.

예외

assemblyName 또는 typeNamenull인 경우assemblyName or typeName is null.

형식을 로드할 수 없는 경우.The type cannot be loaded.

언로드된 애플리케이션 도메인에서 작업이 시도됩니다.The operation is attempted on an unloaded application domain.

매개 변수가 없는 public 생성자를 찾지 못한 경우No public parameterless constructor was found.

assemblyFile가 없는 경우assemblyFile is not found.

typeName는 추상 클래스입니다.typeName is an abstract class.

또는-or- 이 멤버가 런타임에 바인딩된 메커니즘을 사용하여 호출되었습니다.This member was invoked with a late-binding mechanism.

호출자가 MarshalByRefObject에서 상속되지 않는 개체에 대한 활성화 특성을 제공할 수 없습니다.The caller cannot provide activation attributes for an object that does not inherit from MarshalByRefObject.

assemblyFile가 빈 문자열("")입니다.assemblyFile is the empty string ("").

assemblyFile는 유효한 어셈블리가 아닙니다.assemblyFile is not a valid assembly.

어셈블리 또는 모듈이 서로 다른 두 증명 정보로 두 번 로드되었습니다.An assembly or module was loaded twice with two different evidences.

참조되는 COM 개체가 null인 경우The COM object that is being referred to is null.

설명

이 메서드를 사용 하 여 형식을 로컬로 로드 하지 않고도 원격으로 개체를 만들 수 있습니다.Use this method to create objects remotely without having to load the type locally.

실제 개체에 액세스 하려면 반환 값을 래핑 해제 해야 합니다.The return value must to be unwrapped to access the real object.

값이 trueSystem.Runtime.InteropServices.ComVisibleAttribute 특성은 해당 형식의 인스턴스를 만들기 위해이 메서드에 대해 명시적으로 또는 기본적으로 COM 형식에 적용 되어야 합니다. 그렇지 않으면 TypeLoadException이 throw 됩니다.A System.Runtime.InteropServices.ComVisibleAttribute attribute with a value of true must be applied either explicitly or by default to the COM type for this method to create an instance of that type; otherwise, TypeLoadException is thrown.

보안

FileIOPermissionAccess
어셈블리 매니페스트가 포함 된 파일을 읽을 수 있습니다.for the ability to read the file containing the assembly manifest. 연결 된 열거형: ReadAssociated enumeration: Read

WebPermission
어셈블리가 로컬이 아닌 경우 어셈블리의 위치에 액세스할 수 있습니다.for the ability to access the location of the assembly if the assembly is not local.

추가 정보

적용 대상