Cómo: Crear contenedores manualmente

Artículo
10/07/2008

Actualización: noviembre 2007

Si decide declarar manualmente los tipos COM en código fuente administrado, lo mejor es empezar con un archivo o una biblioteca de tipos existente del Lenguaje de definición de interfaz (IDL). Cuando no tiene el archivo IDL o no puede generar un archivo de biblioteca de tipos, puede simular los tipos COM si crea declaraciones administradas y exporta el ensamblado resultante a una biblioteca de tipos.

Para simular tipos COM a partir de código fuente administrado

Declare los tipos en un lenguaje compatible con Common Language Specification (CLS) y compile el archivo.
Exporte el ensamblado que contiene los tipos con la herramienta Exportador de la biblioteca de tipos (Tlbexp.exe).
Utilice la biblioteca de tipos COM exportada como base para declarar tipos administrados orientados a COM.

Para crear un contenedor invocable en tiempo de ejecución (RCW)

Suponiendo que tiene un archivo IDL o un archivo de biblioteca de tipos, decida qué clases e interfaces desea incluir en el RCW personalizado. Puede excluir cualquier tipo que no piense utilizar directa o indirectamente en su aplicación.
Cree un archivo código fuente en un lenguaje compatible con CLS y declare los tipos. Vea Resumen de la conversión de bibliotecas de tipos en ensamblados para obtener una descripción completa del proceso de conversión de importación. Cuando se crea un RCW personalizado, se realiza manualmente la conversión de tipos proporcionada por el Importador de la biblioteca de tipos (Tlbimp.exe). El ejemplo incluido después de este procedimiento muestra los tipos de un IDL o un archivo de biblioteca de tipos y sus tipos correspondientes en código de C#.
Una vez completadas las declaraciones, compile el archivo de la misma forma que compila cualquier otro código fuente administrado.
Como ocurre con los tipos importados con Tlbimp.exe, algunos requieren información adicional, que puede agregar directamente al código. Para obtener más detalles, vea Editar un ensamblado de interoperabilidad.

Ejemplo

En el siguiente código se muestra un ejemplo de la interfaz ISATest y la clase SATest en IDL, y los tipos correspondientes en código fuente de C#.

Archivo IDL o de biblioteca de tipos

 [
object,
uuid(40A8C65D-2448-447A-B786-64682CBEF133),
dual,
helpstring("ISATest Interface"),
pointer_default(unique)
 ]
interface ISATest : IDispatch
 {
[id(1), helpstring("method InSArray")] 
HRESULT InSArray([in] SAFEARRAY(int) *ppsa, [out,retval] int *pSum);
 };
 [
uuid(116CCA1E-7E39-4515-9849-90790DA6431E),
helpstring("SATest Class")
 ]
coclass SATest
 {
  [default] interface ISATest;
 };

Contenedor en código fuente administrado

using System;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;
 
[assembly:Guid("E4A992B8-6F5C-442C-96E7-C4778924C753")]
[assembly:ImportedFromTypeLib("SAServerLib")]
namespace SAServer
{
 [ComImport]
 [Guid("40A8C65D-2448-447A-B786-64682CBEF133")]
 [TypeLibType(TypeLibTypeFlags.FLicensed)]
 public interface ISATest
 {
  [DispId(1)]
  //[MethodImpl(MethodImplOptions.InternalCall,
  // MethodCodeType=MethodCodeType.Runtime)]
  int InSArray( [MarshalAs(UnmanagedType.SafeArray,
      SafeArraySubType=VarEnum.VT_I4)] ref int[] param );
 } 
 [ComImport]
 [Guid("116CCA1E-7E39-4515-9849-90790DA6431E")]
 [ClassInterface(ClassInterfaceType.None)] 
 [TypeLibType(TypeLibTypeFlags.FCanCreate)]
 public class SATest : ISATest 
 {
  [DispId(1)]
  [MethodImpl(MethodImplOptions.InternalCall, 
  MethodCodeType=MethodCodeType.Runtime)]
  extern int ISATest.InSArray( [MarshalAs(UnmanagedType.SafeArray, 
  SafeArraySubType=VarEnum.VT_I4)] ref int[] param );
 }
}

Vea también

Cómo: Crear contenedores manualmente

Para simular tipos COM a partir de código fuente administrado

Para crear un contenedor invocable en tiempo de ejecución (RCW)

Ejemplo

Vea también

Tareas

Conceptos

Referencia

Otros recursos

Recursos adicionales