Compartir a través de


AppDomain.CreateComInstanceFrom Método

Definición

Crea una nueva instancia de un tipo COM especificado.

Sobrecargas

CreateComInstanceFrom(String, String)

Crea una nueva instancia de un tipo COM especificado. Los parámetros especifican el nombre de un archivo que contiene un ensamblado que contiene el tipo y el nombre del tipo.

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

Crea una nueva instancia de un tipo COM especificado. Los parámetros especifican el nombre de un archivo que contiene un ensamblado que contiene el tipo y el nombre del tipo.

CreateComInstanceFrom(String, String)

Crea una nueva instancia de un tipo COM especificado. Los parámetros especifican el nombre de un archivo que contiene un ensamblado que contiene el tipo y el nombre del 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

Nombre de un archivo que contiene un ensamblado que define el tipo solicitado.

typeName
String

Nombre del tipo solicitado.

Devoluciones

Objeto que es un contenedor para la nueva instancia especificada por typeName. El valor devuelto debe desencapsularse para tener acceso al objeto real.

Excepciones

assemblyName o typeName es null.

No se puede cargar el tipo.

La operación se intenta en un dominio de aplicación descargado.

No se encontró ningún constructor público sin parámetros.

no se encuentra assemblyName.

typeName es una clase abstracta.

-o-

Este miembro se invocó con un mecanismo de enlace en tiempo de ejecución.

El autor de la llamada no puede proporcionar atributos de activación para un objeto que no herede de MarshalByRefObject.

assemblyName es una cadena vacía ("").

assemblyName no es un ensamblado válido.

Un ensamblado o módulo se cargó dos veces con dos evidencias diferentes.

El objeto COM al que se hace referencia es null.

Ejemplos

En el ejemplo siguiente se muestra

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

Comentarios

Use este método para crear objetos de forma remota sin tener que cargar el tipo localmente.

El valor devuelto debe desencapsularse para tener acceso al objeto real.

Un atributo System.Runtime.InteropServices.ComVisibleAttribute con un valor de true debe aplicarse explícitamente o de forma predeterminada al tipo COM para que este método cree una instancia de ese tipo; De lo contrario, se produce TypeLoadException.

Consulte también

Se aplica a

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

Crea una nueva instancia de un tipo COM especificado. Los parámetros especifican el nombre de un archivo que contiene un ensamblado que contiene el tipo y el nombre del tipo.

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

Parámetros

assemblyFile
String

Nombre de un archivo que contiene un ensamblado que define el tipo solicitado.

typeName
String

Nombre del tipo solicitado.

hashValue
Byte[]

Representa el valor del código hash calculado.

hashAlgorithm
AssemblyHashAlgorithm

Representa el algoritmo hash utilizado por el manifiesto de ensamblado.

Devoluciones

Objeto que es un contenedor para la nueva instancia especificada por typeName. El valor devuelto debe desencapsularse para tener acceso al objeto real.

Excepciones

assemblyFile o typeName es null.

No se puede cargar el tipo.

La operación se intenta en un dominio de aplicación descargado.

No se encontró ningún constructor público sin parámetros.

no se encuentra assemblyFile.

typeName es una clase abstracta.

-o-

Este miembro se invocó con un mecanismo de enlace en tiempo de ejecución.

El autor de la llamada no puede proporcionar atributos de activación para un objeto que no herede de MarshalByRefObject.

assemblyFile es la cadena vacía ("").

assemblyFile no es un ensamblado válido.

Un ensamblado o módulo se cargó dos veces con dos evidencias diferentes.

El objeto COM al que se hace referencia es null.

Comentarios

Use este método para crear objetos de forma remota sin tener que cargar el tipo localmente.

El valor devuelto debe desencapsularse para tener acceso al objeto real.

Un atributo System.Runtime.InteropServices.ComVisibleAttribute con un valor de true debe aplicarse explícitamente o de forma predeterminada al tipo COM para que este método cree una instancia de ese tipo; De lo contrario, se produce TypeLoadException.

Consulte también

Se aplica a