AppDomain.CreateComInstanceFrom Método

Referência

Definição

Namespace:: System

Assembly:: mscorlib.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria uma nova instância de um tipo COM especificado.

Sobrecargas

CreateComInstanceFrom(String, String)	Cria uma nova instância de um tipo COM especificado. Parâmetros especificam o nome de um arquivo que contém um assembly com o tipo e o nome do tipo.
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)	Cria uma nova instância de um tipo COM especificado. Parâmetros especificam o nome de um arquivo que contém um assembly com o tipo e o nome do tipo.

CreateComInstanceFrom(String, String)

Cria uma nova instância de um tipo COM especificado. Parâmetros especificam o nome de um arquivo que contém um assembly com o tipo e o nome do tipo.

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

Parâmetros

assemblyName: String

O nome de um arquivo que contém um assembly que define o tipo solicitado.

typeName: String

O nome do módulo solicitado.

Retornos

ObjectHandle

Um objeto que é um wrapper para a nova instância especificada por typeName. O valor de retorno precisa ser desencapsulado para acessar o objeto real.

Exceções

ArgumentNullException

assemblyName ou typeName é null.

TypeLoadException

O tipo não pode ser carregado.

AppDomainUnloadedException

A operação é tentada em um domínio de aplicativo descarregado.

MissingMethodException

Nenhum construtor público sem parâmetros foi encontrado.

FileNotFoundException

assemblyName não foi encontrado.

MemberAccessException

typeName é uma classe abstrata.

- ou -

Este membro foi invocado com um mecanismo de associação tardia.

NotSupportedException

O chamador não pode fornecer atributos de ativação para um objeto que não seja herdado de MarshalByRefObject.

ArgumentException

assemblyName é uma cadeia de caracteres vazia ("").

BadImageFormatException

assemblyName não é um assembly válido.

FileLoadException

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.

NullReferenceException

O objeto COM que está sendo referenciado é null.

Exemplos

O exemplo a seguir demonstra

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);
      }
   }
}

open System
open System.Runtime.InteropServices

[<ComVisible true>]
type MyComVisibleType() =
    do
        printfn "MyComVisibleType instantiated!"

[<ComVisible false>]
type MyComNonVisibleType() =
    do
        printfn "MyComNonVisibleType instantiated!"

let createComInstance typeName =
    try
        let currentDomain = AppDomain.CurrentDomain
        let assemblyName = currentDomain.FriendlyName
        currentDomain.CreateComInstanceFrom(assemblyName, typeName)
        |> ignore
    with e ->
        printfn $"{e.Message}"

createComInstance "MyComNonVisibleType"   // Fail!
createComInstance "MyComVisibleType"      // OK!

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

Comentários

Use esse método para criar objetos remotamente sem precisar carregar o tipo localmente.

O valor retornado deve ser desembrulhado para acessar o objeto real.

Um System.Runtime.InteropServices.ComVisibleAttribute atributo com um valor de true deve ser aplicado explicitamente ou por padrão ao tipo COM desse método para criar uma instância desse tipo; caso contrário, TypeLoadException é gerado.

Confira também

CreateComInstanceFrom(String, String)

Aplica-se a

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