Empaquetar un ensamblado para COM

Actualización: noviembre 2007

Los programadores de COM pueden beneficiarse de la siguiente información acerca de los tipos administrados que piensan incluir en su aplicación:

  • Una lista de tipos que las aplicaciones COM pueden consumir

    Ciertos tipos administrados no son visibles para COM; otros son visibles pero no pueden crearse; y otros son visibles y pueden crearse. Un ensamblado puede contener cualquier combinación de tipos visibles, no visibles, que pueden crearse y que no pueden crearse. Para obtener un mejor resultado, identifique los tipos de un ensamblado que piensa exponer en COM, especialmente cuando dichos tipos sean un subconjunto de los tipos expuestos en .NET Framework.

    Para obtener información adicional, vea Habilitar tipos de .NET para la interoperación.

  • Instrucciones relativas al control de versiones

    Las clases administradas que implementan la interfaz de clase (una interfaz generada por la interoperabilidad COM) están sometidas a restricciones del control de versiones.

    Para obtener instrucciones sobre el uso de la interfaz de clase, vea Presentar la interfaz de clase.

  • Instrucciones de implementación

    Los ensamblados con nombre seguro y firmados por un editor pueden instalarse en la caché de ensamblados global. Los ensamblados que no están firmados deben instalarse en el equipo del usuario como ensamblados privados.

    Para obtener más información, vea Consideraciones de seguridad de ensamblados.

  • Inclusión de bibliotecas de tipos

    La mayoría de los tipos requieren una biblioteca de tipos cuando una aplicación COM los consume. La generación de una biblioteca de tipos es una tarea que puede realizar el usuario o que pueden realizar los programadores de COM. Kit de desarrollo de software de Windows (SDK) proporciona las opciones siguientes para generar una biblioteca de tipos:

    • Exportador de la biblioteca de tipos

    • Clase TypeLibConverter

    • Herramienta Registro de ensamblados

    • Herramienta Instalación de servicios de .NET

    Independientemente del mecanismo que se elija, sólo se incluirán en la biblioteca de tipos generada los tipos públicos definidos en el ensamblado proporcionado por el usuario.

    Puede empaquetar una biblioteca de tipos como un archivo independiente o incrustarla como un archivo de recursos Win32 dentro de una aplicación .NET. Microsoft Visual Basic 6.0 realiza esta tarea automáticamente; sin embargo, cuando utilice Microsoft Visual Basic 2005, debe incrustar la biblioteca de tipos manualmente. Para obtener instrucciones, vea Cómo: Incrustar bibliotecas de tipos como recursos de Win32 en aplicaciones basadas en .NET.

Exportador de la biblioteca de tipos

El Exportador de la biblioteca de tipos (Tlbexp.exe) es una herramienta de línea de comandos que convierte en una biblioteca de tipos COM las clases e interfaces contenidas en un ensamblado. Una vez que la información sobre el tipo de la clase está disponible, los clientes COM pueden crear una instancia de la clase de .NET y llamar a los métodos de la instancia, del mismo modo que si se tratase de un objeto COM. Tlbexp.exe convierte todo un ensamblado de una vez. No se puede utilizar Tlbexp.exe para generar información de tipos correspondiente a un subconjunto de los tipos definidos en un ensamblado.

Clase TypeLibConverter

La clase TypeLibConverter, ubicada en el espacio de nombres System.Runtime.Interop, convierte las clases e interfaces de un ensamblado en una biblioteca de tipos COM. Esta API genera la misma información de tipos que la herramienta Exportador de la biblioteca de tipos, descrita en la sección anterior.

La clase TypeLibConverter implementa la interfaz ITypeLibConverter.

Herramienta Registro de ensamblados

La herramienta Registro de ensamblados (Regasm.exe) puede generar y registrar una biblioteca de tipos cuando se aplica la opción /tlb:. Los clientes COM requieren que las bibliotecas de tipos se instalen en el Registro de Windows. Sin esta opción, Regasm.exe sólo registra los tipos de un ensamblado, no la biblioteca de tipos. El registro de los tipos de un ensamblado y el registro de una biblioteca de tipos son actividades distintas.

Herramienta Instalación de servicios de .NET

La herramienta Instalación de servicios de .NET (Regsvcs.exe) agrega clases administradas a los servicios de componentes de Windows 2000 y combina varias tareas en una sola herramienta. Además de cargar y registrar un ensamblado, Regsvcs.exe puede generar, registrar e instalar la biblioteca de tipos en una aplicación COM+ 1.0 existente.

Vea también

Tareas

Cómo: Incrustar bibliotecas de tipos como recursos de Win32 en aplicaciones basadas en .NET

Conceptos

Exponer componentes de .NET Framework en COM

Habilitar tipos de .NET para la interoperación

Presentar la interfaz de clase

Consideraciones de seguridad sobre ensamblados

Registrar ensamblados con COM

Referencia

Exportador de la biblioteca de tipos (Tlbexp.exe)

TypeLibConverter

ITypeLibConverter