Leer en inglés

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 (string assemblyName, string typeName);

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

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

.NET Framework 4.8.1 y otras versiones
Producto Versiones
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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 (string assemblyFile, string typeName, byte[] hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

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

.NET Framework 4.8.1 y otras versiones
Producto Versiones
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1