Manifiestos de ensamblado

Un manifiesto de ensamblado es un archivo XML que describe un ensamblado en paralelo. Los manifiestos de ensamblado describen los nombres y versiones de ensamblados, archivos y recursos en paralelo del ensamblado, así como la dependencia del ensamblado en otros ensamblados en paralelo. La instalación, activación y ejecución correctas de ensamblados en paralelo requiere que el manifiesto del ensamblado siempre acompañe a un ensamblado en el sistema.

Para obtener una lista completa del esquema XML, vea Esquema de archivo de manifiesto.

Los manifiestos de ensamblado tienen los siguientes elementos y atributos.

Elemento	Atributos	Obligatorio
assembly		Sí
	manifestVersion	Sí
noInheritable		No
assemblyIdentity		Sí
	type	Sí
	name	Sí
	language	No
	processorArchitecture	No
	version	Sí
	publicKeyToken	No
Dependencia		No
dependentAssembly		No
file		No
	name	Sí
	hashalg	No
	hash	No
comClass		No
	description	No
	clsid	Sí
	threadingModel	No
	tlbid	No
	progid	No
	miscStatus	No
	miscStatusIcon	No
	miscStatusContent	No
	miscStatusDocPrint	No
	miscStatusThumbnail	No
typelib		No
	tlbid	Sí
	version	Sí
	helpdir	Sí
	resourceid	No
	flags	No
comInterfaceExternalProxyStub		No
	iid	Sí
	baseInterface	No
	numMethods	No
	name	No
	tlbid	No
	proxyStubClsid32	No
comInterfaceProxyStub		No
	iid	Sí
	name	Sí
	tlbid	No
	baseInterface	No
	numMethods	No
	proxyStubClsid32	No
	threadingModel	No
windowClass		No
	Versionado	No

Ubicación del archivo

Los manifiestos de ensamblado se pueden instalar en tres ubicaciones:

• Como manifiestos que acompañan a ensamblados compartidos, los manifiestos de ensamblado deben instalarse como un archivo independiente en la caché de ensamblados en paralelo. Normalmente, esta es la carpeta WinSxS en el directorio de Windows.
• Como manifiestos que acompañan a ensamblados privados, los manifiestos de ensamblado deben instalarse en la estructura de directorios de la aplicación. Normalmente, se trata de un archivo independiente en la misma carpeta que el archivo ejecutable de la aplicación.
• Como recurso en un archivo DLL, el ensamblado está disponible para el uso privado del archivo DLL. No se puede incluir un manifiesto de ensamblado como un recurso en un EXE. Un archivo EXE puede incluir un manifiesto de aplicación como un recurso.

Sintaxis de los nombres de archivo

El nombre de un manifiesto de ensamblado es cualquier nombre de archivo válido seguido de .manifest.

Por ejemplo, un manifiesto de ensamblado que hace referencia a myassembly usaría la siguiente sintaxis de nombre de archivo: myassembly.<resource ID>.manifest. Puede omitir el <resource ID> campo si el manifiesto del ensamblado se está instalando como un archivo independiente o si el identificador de recurso es 1.

Nota

Debido a la forma en que se buscan ensamblados privados en paralelo, se aplican las siguientes restricciones de nomenclatura al empaquetar un archivo DLL como un ensamblado privado. Una manera recomendada de hacerlo es colocar el manifiesto de ensamblado en el archivo DLL como un recurso. En este caso, el identificador de recurso debe ser igual a 1 y el nombre del ensamblado privado puede ser el mismo que el nombre del archivo DLL. Por ejemplo, si el nombre del archivo DLL es Microsoft.Windows.mysample.dll, el valor del atributo name usado en el elemento assemblyIdentity del manifiesto también puede ser Microsoft.Windows.mysample. Una manera alternativa es colocar el manifiesto del ensamblado en un archivo independiente. En este caso, el nombre del ensamblado y su manifiesto deben ser diferentes del nombre del archivo DLL. Por ejemplo, Microsoft.Windows.mysampleAsm, Microsoft.Windows.mysampleAsm.manifest y Microsoft.Windows.Mysample.dll. Para obtener más información sobre cómo buscar ensamblados privados en paralelo, vea Secuencia de búsqueda de ensamblados.

Elementos

Los nombres de los elementos y atributos distinguen mayúsculas de minúsculas. Los valores de los elementos y atributos no distinguen mayúsculas de minúsculas, excepto el valor del atributo de tipo.

ensamblaje

Un elemento contenedor. Su primer subelemento debe ser un elemento assemblyIdentity o noInheritable . El manifiesto del ensamblado describe de forma única el ensamblado en paralelo identificado por assemblyIdentity. Necesario.

El elemento de ensamblado debe estar en el espacio de nombres "urn:schemas-microsoft-com:asm.v1". Los elementos secundarios del ensamblado también deben estar en este espacio de nombres, mediante herencia o etiquetado.

El elemento assembly tiene el atributo siguiente.

Atributo	Descripción
manifestVersion	El atributo manifestVersion debe establecerse en 1.0.

noInheritable

Incluya este elemento en un manifiesto de ensamblado para indicar que el ensamblado administra los contextos de activación y sus objetos. El elemento noInheritable debe ser un subelemento de un elemento de ensamblado . El elemento assemblyIdentity debe aparecer después de cualquier elemento noInheritable . El elemento noInheritable es necesario en el manifiesto del ensamblado si cualquier manifiesto de aplicación que incluya el elemento noInherit usa el ensamblado. Un elemento noInheritable de un manifiesto de aplicación no tiene ningún efecto. Un elemento noInheritable no tiene elementos secundarios.

Assemblyidentity

Describe e identifica de forma única un ensamblado en paralelo.

Como primer subelemento de un elemento de ensamblado , assemblyIdentity describe e identifica de forma única el ensamblado en paralelo que posee este manifiesto de ensamblado. Esto se denomina ensamblado DEF-contextIdentity del manifiesto del ensamblado.

Como primer subelemento de un elemento dependentAssembly , assemblyIdentity describe e identifica de forma única un ensamblado en paralelo que usa el ensamblado de contexto DEFIdentity. Esto se denomina assemblyIdentity ref-context del manifiesto del ensamblado. El ensamblado DEF-context requiere que el ensamblado REF-context funcione correctamente. Tenga en cuenta que cada assemblyIdentity ref-context debe coincidir exactamente con un assemblyIdentity de contexto DEF correspondiente en el manifiesto de ensamblado propio del ensamblado al que se hace referencia.

Este elemento no tiene subelementos. El elemento assemblyIdentity tiene los siguientes atributos.

Atributo	Descripción
type	Especifica el tipo de ensamblado. El valor debe ser win32 y en minúsculas. Necesario.
name	Asigna un nombre único al ensamblado. Use el siguiente formato para el nombre del ensamblado: Organization.Division.Name. Por ejemplo, Microsoft.Windows.mysampleAsm. Necesario. Tenga en cuenta que, en el caso de un archivo DLL empaquetado como un ensamblado privado con un archivo de manifiesto independiente, el nombre del ensamblado debe ser diferente del nombre del archivo DLL y el manifiesto.
language	Identifica el idioma del ensamblado. Opcional. Si el ensamblado es específico del lenguaje, especifique el código de lenguaje DHTML. En el ensamblado DEF-contextIdentity de un manifiesto de ensamblado destinado a uso mundial (neutral del lenguaje) se omite el atributo language. En un ensamblado ref-contextIdentity de un manifiesto de ensamblado destinado a uso mundial (neutral del lenguaje), establezca el valor del idioma en "*".
processorArchitecture	Especifica el procesador. Los valores válidos son x86 para Windows de 32 bits y ia64 para Windows de 64 bits. Opcional.
version	Especifica la versión del ensamblado. Use el formato de versión de cuatro partes: mmmmm.nnnnn.oooo.ppppp. Cada una de las partes separadas por períodos puede ser de 0 a 65535 inclusive. Para obtener más información, vea Versiones de ensamblado. Necesario.
publicKeyToken	Cadena hexadecimal de 16 caracteres que representa los últimos 8 bytes del hash SHA-1 de la clave pública con la que se firma el ensamblado. La clave pública usada para firmar el catálogo debe ser de 2048 bits o superior. Necesario para ensamblados en paralelo compartidos.

Dependencia

Elemento contenedor que incluye al menos un elemento dependentAssembly. El primer subelemento debe ser un elemento dependentAssembly . Una dependencia no tiene atributos. Opcional.

dependentAssembly

El primer subelemento debe ser un elemento assemblyIdentity que describa e identifique de forma única un ensamblado en paralelo que usa el ensamblado en paralelo que posee este manifiesto de ensamblado. Cada dependienteAssembly debe estar dentro exactamente de una dependencia. Opcional.

Archivo

Contiene archivos usados por un ensamblado en paralelo. Contiene subelementos comClass, typelib, windowClass, comInterfaceProxyStub . Opcional.

El elemento file tiene los siguientes atributos.

Atributo	Descripción
name	Nombre del archivo, por ejemplo, Conctl32.dll.
hashalg	Algoritmo usado para crear un hash del archivo. Este valor debe ser SHA1.
hash	Hash del archivo al que se hace referencia por nombre. Cadena hexadecimal de longitud en función del algoritmo hash.

comClass

Subelemento de un elemento de archivo . Opcional.

El elemento comClass tiene los siguientes atributos.

Atributo	Descripción
description	Nombre de clase.
clsid	GUID que identifica de forma única la clase . Necesario. El valor debe tener el formato de un GUID válido.
threadingModel	El modelo de subprocesos utilizado por las clases COM en proceso. Si esta propiedad es null, no se usa ningún modelo de subproceso. El componente se crea en el subproceso principal del cliente y las llamadas de otros subprocesos se serializarán en este subproceso. Opcional. Los valores válidos son: "Apartment", "Free", "Both" y "Neutral".
tlbid	GUID de la biblioteca de tipos para este componente COM. El valor debe tener el formato de un GUID. Opcional.
progid	Identificador de programación dependiente de la versión asociado al componente COM. El formato de un ProgID es <proveedor>.<componente>.<versión>.
miscStatus	Duplicados en el ensamblado manifiestan la información proporcionada por la clave del Registro MiscStatus. Si no se encuentran los valores de los atributos miscStatusIcon, miscStatusContent, miscStatusDocprint o miscStatusThumbnail , se usa el valor predeterminado correspondiente enumerado en miscStatus para los atributos que faltan. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere valores de clave del Registro Miscstatus.
miscStatusIcon	Duplica en el manifiesto del ensamblado la información proporcionada por DVASPECT_ICON. Puede proporcionar un icono de un objeto. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere valores de clave del Registro Miscstatus.
miscStatusContent	Duplica en el manifiesto del ensamblado la información proporcionada por DVASPECT_CONTENT. Puede proporcionar un documento compuesto que se pueda mostrar para una pantalla o impresora. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere valores de clave del Registro Miscstatus.
miscStatusDocprint	Duplica en el manifiesto del ensamblado la información proporcionada por DVASPECT_DOCPRINT. Puede proporcionar una representación de objeto que se muestre en la pantalla como si se imprimiera en una impresora. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere valores de clave del Registro Miscstatus.
miscStatusThumbnail	Duplica en un manifiesto de ensamblado la información proporcionada por DVASPECT_THUMBNAIL. Puede proporcionar una miniatura de un objeto que se puede mostrar en una herramienta de exploración. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere valores de clave del Registro Miscstatus.

El elemento comClass puede tener <elementos progid>... como elementos secundarios, que enumeran los progid dependientes de la versión.

En el ejemplo siguiente se muestra un elemento comClass incluido en un elemento file .

<file name="sampleu.dll">
        <comClass description="Font Property Page"
    clsid="{0BE35200-8F91-11CE-9DE3-00AA004BB851}"
          threadingModel = "Both"
             tlbid = "{44EC0535-400F-11D0-9DCD-00A0C90391D3}"/>
        <comClass description="Color Property Page"
    clsid="{0BE35201-8F91-11CE-9DE3-00AA004BB851}" 
    progid="ABC.Registrar"/>
    </file>

Si la clase COM es una clase OCX que requiere la subclave del Registro MiscStatus para especificar cómo crear y mostrar un objeto, puede habilitar el objeto duplicando esta información en el manifiesto del ensamblado. Especifique las características del objeto mediante los atributos miscStatus, miscStatusIcon, miscStatusContent, miscStatusDocprint y miscStatusThumbnail del elemento comClass . Establezca estos atributos en una lista separada por comas de valores de atributo de la tabla siguiente. Estos atributos duplican la información proporcionada por una enumeración DVASPECT. Si no se encuentra ningún valor para miscStatusIcon, miscStatusContent, miscStatusDocprint o miscStatusThumbnail, se usan los valores predeterminados especificados en miscStatus . Use valores de atributo de la tabla siguiente. Estas corresponden a las marcas de bits de una enumeración OLEMISC .

Valor del atributo	OleMISC (constante)
recomposeonresize	OLEMISC_RECOMPOSEONRESIZE
onlyiconic	OLEMISC_ONLYICONIC
insertnotreplace	OLEMISC_INSERTNOTREPLACE
static	OLEMISC_STATIC
cantlinkinside	OLEMISC_CANTLINKINSIDE
canlinkbyole1	OLEMISC_CANLINKBYOLE1
islinkobject	OLEMISC_ISLINKOBJECT
Insideout	OLEMISC_INSIDEOUT
activatewhenvisible	OLEMISC_ACTIVATEWHENVISIBLE
renderingisdeviceindependent	OLEMISC_RENDERINGISDEVICEINDEPENDENT
invisibleatruntime	OLEMISC_INVISIBLEATRUNTIME
alwaysrun	OLEMISC_ALWAYSRUN
actlikebutton	OLEMISC_ACTSLIKEBUTTON
actlikelabel	OLEMISC_ACTSLIKELABEL
nouiactivate	OLEMISC_NOUIACTIVATE
alineable	OLEMISC_ALIGNABLE
simpleframe	OLEMISC_SIMPLEFRAME
setclientsitefirst	OLEMISC_SETCLIENTSITEFIRST
Imemode	TOLEMISC_IMEMODE
ignoreativatewhenvisible	OLEMISC_IGNOREACTIVATEWHENVISIBLE
wantstomenumerge	OLEMISC_WANTSTOMENUMERGE
supportsmultilevelundo	OLEMISC_SUPPORTSMULTILEVELUNDO

Typelib

Subelemento de un elemento de archivo . Opcional.

El elemento typelib tiene los atributos que se muestran en la tabla siguiente.

Atributo	Descripción
tlbid	Id. único de la biblioteca de tipos. Necesario.
version	Número de versión de dos partes de la biblioteca de tipos. Si solo aumenta el número de versión secundaria, todas las características de la biblioteca de tipos anterior se admiten de forma compatible. Si cambia el número de versión principal, se debe volver a compilar el código compilado en la biblioteca de tipos. El número de versión de la biblioteca de tipos puede diferir del número de versión de la aplicación. Necesario.
helpdir	Directorio donde se encuentra el archivo de Ayuda para los tipos de la biblioteca de tipos. Si la aplicación admite bibliotecas de tipos para varios lenguajes, las bibliotecas pueden hacer referencia a nombres de archivo diferentes en el directorio del archivo de Ayuda. Si no hay ningún valor, especifique "". Necesario.
resourceid	La representación hexadecimal en cadena del identificador de configuración regional (LCID). Es de uno a cuatro dígitos hexadecimales sin prefijo 0x y sin ceros iniciales. El LCID puede tener un identificador de sublanguaje neutro. Para obtener más información, consulte Identificadores de configuración regional. Opcional.
flags	La representación en cadena de las banderas de la biblioteca de tipos para esta biblioteca de tipos. En concreto, debe ser "RESTRICTED", "CONTROL", "HIDDEN" y "HASDISKIMAGE". Estos son los valores de la enumeración LIBFLAGS y son las mismas marcas especificadas en el parámetro uLibFlags del método ICreateTypeLib::SetLibFlags . Opcional.

En el ejemplo siguiente se muestra un elemento typelib incluido en un elemento file .

<file name="sampleu.dll">
       <typelib tlbid="{44EC0535-400F-11D0-9DCD-00A0C90391D3}"
       version="1.0" helpdir=""/>
</file>

comInterfaceExternalProxyStub

ComInterfaceExternalProxyStub es un subelemento de un elemento de ensamblado y se usa para interfaces de automatización. Por ejemplo, IDispatch y sus interfaces derivadas. Opcional.

La implementación predeterminada del código auxiliar de proxy es adecuada para la mayoría de las interfaces de automatización, como las interfaces derivadas de IDispatch. El código auxiliar del proxy de interfaz y todas las demás implementaciones externas de interfaz proxy-stub deben aparecer en comInterfaceExternalProxyStub. El elemento comInterfaceExternalProxyStub tiene los atributos que se muestran en la tabla siguiente.

Atributo	Descripción
iid	IID de la interfaz para la que se declara el proxy. Necesario. El valor debe tener el formato : "{iid}".
baseInterface	IID de la interfaz desde la que se deriva el que describe el atributo iid . Este atributo es opcional. El valor debe tener el formato : "{iid}".
numMethods	Número de métodos implementados por la interfaz. Este atributo es opcional. El valor debe tener el formato : "n".
name	Nombre de la interfaz tal como aparecería en el código. Por ejemplo, "IViewObject". Esto no debe ser una cadena descriptiva. Este atributo es opcional. El valor debe tener el formato : "name".
tlbid	Biblioteca de tipos que contiene la descripción de la interfaz especificada por el atributo iid . Este atributo es opcional. El valor debe tener el formato : "{tlbid}" .
proxyStubClsid32	Asigna un IID a un CLSID en archivos DLL de proxy de 32 bits.

En el ejemplo siguiente se muestra un elemento comInterfaceExternalProxyStub .

<comInterfaceExternalProxyStub 
  name="IAxWinAmbientDispatch" 
    iid="{B6EA2051-048A-11D1-82B9-00C04FB9942E}" 
    numMethods="35" 
  baseInterface="{00000000-0000-0000-C000-000000000046}"/>

comInterfaceProxyStub

Subelemento de un elemento de archivo . Opcional.

Si un archivo del ensamblado implementa un código auxiliar de proxy, la etiqueta de archivo correspondiente debe incluir un subelemento comInterfaceProxyStub que tenga atributos idénticos a un elemento comInterfaceProxyStub . Es posible que la serialización de interfaces entre procesos y subprocesos no funcione según lo previsto si omite algunas de las dependencias comInterfaceProxyStub del componente.

El elemento comInterfaceProxyStub tiene los siguientes atributos.

Atributo	Descripción
iid	El. IID de la interfaz para la que se declara el proxy. Necesario. El valor debe tener el formato : "{iid}".
name	Nombre de la interfaz tal como aparecería en el código. Por ejemplo, "IViewObject". Esto no debe ser una cadena descriptiva. Este atributo es opcional. El valor debe tener el formato : "name".
tlbid	Biblioteca de tipos que contiene la descripción de la interfaz especificada por el atributo iid . Este atributo es opcional. El valor debe tener el formato : "{tlbid}".
baseInterface	IiD de la interfaz desde la que se deriva el que describe el atributo iid . Este atributo es opcional. El valor debe tener el formato : "{iid}".
numMethods	Número de métodos implementados por la interfaz. Este atributo es opcional. El valor debe tener el formato : "n".
proxyStubClsid32	Asigna un IID a un CLSID en archivos DLL de proxy de 32 bits.
threadingModel	El modelo de subprocesos utilizado por las clases COM en proceso. Si esta propiedad es null, no se usa ningún modelo de subprocesos. El componente se crea en el subproceso principal del cliente y las llamadas de otros subprocesos se serializarán en este subproceso. Opcional. Los valores válidos son: "Apartment", "Free", "Both" y "Neutral".

windowclass

Nombre de una clase de Windows que se va a versionar. El elemento windowclass tiene el atributo siguiente.

Atributo

Descripción

Versionado

Este atributo controla si el nombre de clase de ventana interno usado en el registro contiene la versión del ensamblado que contiene la clase de ventana. El valor de este atributo puede ser "sí" o "no". El valor predeterminado es "sí". El valor "no" solo se debe usar si la misma clase de ventana está definida por un componente en paralelo y un componente no en paralelo equivalente y desea tratarlos como la misma clase de ventana. Tenga en cuenta que las reglas habituales sobre el registro de clases de ventana solo aplican el primer componente que registra la clase de ventana podrá registrarla, ya que no tiene versiones.

En el ejemplo siguiente se muestra un elemento windowclass incluido en un elemento file .

<file name="comctl32.dll">
        <windowClass versioned="no">ToolbarWindow32</windowClass>
</file>

Ejemplo

A continuación se muestra un ejemplo de un manifiesto de ensamblado.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" 
manifestVersion="1.0">
    <assemblyIdentity type="win32" name="Microsoft.Tools.SampleAssembly" version="6.0.0.0" processorArchitecture="x86" publicKeyToken="0000000000000000"/>
    <file name="sampleu.dll" hash="3eab067f82504bf271ed38112a4ccdf46094eb5a" hashalg="SHA1">
        <comClass description="Font Property Page" clsid="{0BE35200-8F91-11CE-9DE3-00AA004BB851}"/>
        <comClass description="Color Property Page" clsid="{0BE35201-8F91-11CE-9DE3-00AA004BB851}"/>
        <comClass description="Picture Property Page" clsid="{0BE35202-8F91-11CE-9DE3-00AA004BB851}"/>
    </file>
    <file name="bar.dll" hash="ac72753e5bb20446d88a48c8f0aaae769a962338" hashalg="SHA1"/>
    <file name="foo.dll" hash="a7312a1f6cfb46433001e0540458de60adcd5ec5" hashalg="SHA1">
        <comClass description="Registrar Class" clsid="{44EC053A-400F-11D0-9DCD-00A0C90391D3}" progid="ATL.Registrar"/>
    <comInterfaceProxyStub iid="{B6EA2051-048A-11D1-82B9-00C04FB9942E}" name=" IAxWinAmbientDispatch " tlbid="{34EC053A-400F-11D0-9DCD-00A0C90391D3}"/>
        <typelib tlbid="{44EC0535-400F-11D0-9DCD-00A0C90391D3}" version="1.0" helpdir=""/>
    </file>
    <file name="sampledll.dll" hash="ba62960ceb15073d2598379307aad84f3a73dfcb" hashalg="SHA1"/>
<windowClass>ToolbarWindow32</windowClass>
        <windowClass>ComboBoxEx32</windowClass>
        <windowClass>sample_trackbar32</windowClass>
        <windowClass>sample_updown32</windowClass>
</assembly>