AppDomain.CreateComInstanceFrom Método

Definição

Espaço de Nomes:: System

Assemblagem:: mscorlib.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
CreateComInstanceFrom(String, String)	Cria uma nova instância de um tipo de COM especificado. Os parâmetros especificam o nome de um ficheiro que contém um assembly contendo o tipo e o nome do tipo.
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)	Cria uma nova instância de um tipo de COM especificado. Os parâmetros especificam o nome de um ficheiro que contém um assembly contendo o tipo e o nome do tipo.

CreateComInstanceFrom(String, String)

Cria uma nova instância de um tipo de COM especificado. Os parâmetros especificam o nome de um ficheiro que contém um assembly contendo 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 ficheiro contendo um assembly que define o tipo solicitado.

typeName: String

O nome do tipo pedido.

Devoluções

ObjectHandle

Um objeto que é um wrapper para a nova instância especificado por typeName. O valor de retorno precisa de ser desembrulhado para aceder ao objeto real.

Exceções

ArgumentNullException

assemblyName ou typeName é null.

TypeLoadException

O tipo não pode ser carregado.

AppDomainUnloadedException

A operação é tentada num domínio de aplicação não carregado.

MissingMethodException

Não foi encontrado nenhum construtor público sem parâmetros.

FileNotFoundException

assemblyName não foi encontrado.

MemberAccessException

typeName é uma classe abstrata.

-ou-

Este elemento foi invocado com um mecanismo de ligação tardia.

NotSupportedException

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

ArgumentException

assemblyName é uma cadeia vazia ("").

BadImageFormatException

assemblyName não é uma assembleia válida.

FileLoadException

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

NullReferenceException

O objeto COM a que está a ser referido é null.

Exemplos

O exemplo seguinte 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 CreateComInstanceFromSnippet {
   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

Observações

Use este método para criar objetos remotamente sem ter de carregar o tipo localmente.

O valor de retorno deve ser desembrulhado para aceder ao objeto real.

Um System.Runtime.InteropServices.ComVisibleAttribute atributo com valor de true deve ser aplicado explicitamente ou por defeito ao tipo COM para que este método crie uma instância desse tipo; caso contrário, TypeLoadException é lançado.

Ver também

CreateComInstanceFrom(String, String)

Aplica-se a

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