Cómo: Configurar componentes basados en .NET para la activación sin registro

Artículo
10/07/2008

Actualización: noviembre 2007

La activación sin registro de los componentes .NET es sólo un poco más complicada que la de los componentes COM. La configuración requiere dos manifiestos:

Las aplicaciones COM deben tener un manifiesto de aplicación de estilo Win32 para identificar el componente administrado.
Los componentes .NET deben tener un manifiesto de componente con la información de activación que se necesita en tiempo de ejecución.

En este tema se describe cómo asociar un manifiesto de aplicación a una aplicación, cómo asociar un manifiesto de componente a un componente y cómo incrustar un manifiesto de componente en un ensamblado.

Para crear un manifiesto de aplicación

Mediante un editor XML, cree (o modifique) el manifiesto de aplicación propiedad de la aplicación COM que está interoperando con uno o más componentes administrados.
Inserte el siguiente encabezado estándar al principio del archivo:
```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
```
Para obtener información sobre los elementos del manifiesto y sus atributos, busque "Referencia de manifiestos de aplicación" en MSDN Library.

Identifique al propietario del manifiesto. En el ejemplo siguiente, la versión 1 de myComApp es el propietario del archivo del manifiesto.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity type="win32" 
                    name="myOrganization.myDivision.myComApp" 
                    version="1.0.0.0" 
                    processorArchitecture="x86" 
  />

Identifique los ensamblados dependientes. En el ejemplo siguiente, myComApp depende de myManagedComp.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity type="win32" 
                    name="myOrganization.myDivision.myComApp" 
                    version="1.0.0.0" 
                    processorArchitecture="x86" 
                    publicKeyToken="8275b28176rcbbef"
  />
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type="win32" 
                    name="myOrganization.myDivision.myManagedComp" 
                    version="6.0.0.0" 
                    processorArchitecture="X86" 
                    publicKeyToken="8275b28176rcbbef"
                    language="*"
      />
    </dependentAssembly>
  </dependency>
</assembly>

Nombre el archivo de manifiesto y guárdelo. El nombre de un manifiesto de aplicación es el nombre del ensamblado ejecutable seguido de la extensión .manifest. Por ejemplo, el nombre del archivo de manifiesto de la aplicación de myComApp.exe es myComApp.exe.manifest.

El manifiesto de aplicación se puede instalar en el mismo directorio que la aplicación COM. Opcionalmente, se puede agregar como recurso al archivo .exe de la aplicación. Para obtener más información, busque "Ensamblados simultáneos" en MSDN Library.

Para crear un manifiesto de componente

Mediante un editor XML, cree un manifiesto de componente para describir el ensamblado administrado.

Inserte el siguiente encabezado estándar al principio del archivo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">

Identifique al propietario del archivo. El elemento <assemblyIdentity> del elemento <dependentAssembly> del archivo del manifiesto de aplicación debe coincidir con el del manifiesto de componente. En el ejemplo siguiente, la versión 1.2.3.4 de myManagedComp es el propietario del archivo del manifiesto.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
       <assemblyIdentity
                    name="myOrganization.myDivision.myManagedComp"
                    version="1.2.3.4" />
                    publicKeyToken="8275b28176rcbbef"

Identifique cada clase del ensamblado. Utilice el elemento <clrClass> para identificar cada clase del ensamblado administrado de manera única. El elemento, que es un subelemento del elemento <assembly>, tiene los atributos que se describen en la siguiente tabla.

Atributo	Descripción	Requerido
clsid	El identificador que especifica la clase que ha de ser activada.	Sí
Descripción	Cadena que informa al usuario sobre el componente. De manera predeterminada, es una cadena vacía.	No
nombre	Cadena que representa la clase administrada.	Sí
progid	Identificador que hay que usar para la activación del enlace en tiempo de ejecución.	No
threadingModel	Modelo de subprocesos COM. "Both" es el valor predeterminado.	No
runtimeVersion	Este atributo se pasa por alto. Si el motor en tiempo de ejecución no está todavía cargado, se carga la última versión antes de que la clase se active. En caso contrario, se emplea la versión cargada actualmente.	No
tlbid	Identificador de la biblioteca de tipos que contiene información sobre la clase.	No

Todos los atributos distinguen mayúsculas de minúsculas. Se pueden obtener los CLSID, ProgIDs, modelos de subprocesos y la versión del motor en tiempo de ejecución visualizando la biblioteca de tipos exportada para el ensamblado con OLE/COM ObjectViewer (Oleview.exe).

El siguiente manifiesto de componente identifica una única clase con dos métodos.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
       <assemblyIdentity
                    name="myOrganization.myDivision.myManagedComp"
                    version="1.2.3.4" />
                    publicKeyToken="8275b28176rcbbef"
       <clrClass
                    clsid="{65722BE6-3449-4628-ABD3-74B6864F9739}"
                    progid="myManagedComp.testClass1"
                    threadingModel="Both"
                    name="myManagedComp.testClass1"
                    runtimeVersion="v1.0.3705">
       </clrClass>
       <clrClass
                    clsid="{367221D6-3559-3328-ABD3-45B6825F9732}"
                    progid="myManagedComp.testClass2"
                    threadingModel="Both"
                    name="myManagedComp.testClass2"
                    runtimeVersion="v1.0.3705">
       </clrClass>
       <file name="MyManagedComp.dll">
       </file>
</assembly>

Nombre el archivo de manifiesto y guárdelo. El nombre de un manifiesto de componente es el nombre de la biblioteca de ensamblados seguido de la extensión .manifest. Por ejemplo, myManagedComp.dll es myManagedComp.manifest.

Es necesario incrustar el manifiesto de componente como recurso en el ensamblado

Para incrustar un manifiesto de componente en un ensamblado administrado

Cree una secuencia de comandos de recursos que contenga la siguiente instrucción:

RT_MANIFEST 1 myManagedComp.manifest

En esta instrucción, myManagedComp.manifest es el nombre del manifiesto de componente que se incrusta. En este ejemplo, el archivo de secuencia de comandos se denomina myresource.rc.
Compile la secuencia de comandos mediante el compilador de recursos de Microsoft Windows (Rc.exe). En el símbolo del sistema, escriba el siguiente comando:

rc myresource.rc

Rc.exe produce el archivo de recursos myresource.res.
Compile de nuevo el archivo de código fuente del ensamblado mediante la opción /win32res:
```
/win32res:myresource.res
```
Una vez más, myresource.res es el nombre del archivo de recursos que contiene el recurso incrustado.

Vea también

Conceptos

Requisitos para interoperabilidad COM sin registro

Configurar componentes COM para activación sin registro

Otros recursos

Interoperabilidad COM sin registro

Compartir a través de