Compartir a través de

Manifiesto del ensamblado

Cada ensamblado, ya sea estático o dinámico, contiene una colección de datos que describe cómo se relacionan los elementos del ensamblado entre sí. El manifiesto del ensamblaje contiene los metadatos de ensamblaje. Un manifiesto de ensamblado contiene todos los metadatos necesarios para especificar los requisitos de versión y la identidad de seguridad del ensamblado, y todos los metadatos necesarios para definir el ámbito del ensamblado y resolver las referencias a recursos y clases. El manifiesto de ensamblado se puede almacenar en un archivo PE (un .exe o .dll) con código de lenguaje intermedio común (CIL) o en un archivo PE independiente que solo contiene información del manifiesto de ensamblado.

En la ilustración siguiente se muestran las distintas formas en que se puede almacenar el manifiesto.

Diagrama que muestra el manifiesto en una configuración de ensamblado de un solo archivo y ensamblado de varios archivos.

Para un ensamblado con un archivo asociado, el manifiesto se incorpora al archivo PE para formar un ensamblado de un solo archivo. Puede crear un ensamblado de varios archivos con un archivo de manifiesto independiente o con el manifiesto incorporado en uno de los archivos PE del ensamblado.

Un manifiesto de ensamblado realiza las funciones siguientes:

  • Enumera los archivos que componen el ensamblado.

  • Controla cómo las referencias a los tipos y recursos del ensamblado se asignan a los archivos que contienen sus declaraciones e implementaciones.

  • Enumera otros ensamblados de los que depende este ensamblado.

  • Proporciona un nivel de direccionamiento indirecto entre los consumidores del ensamblado y los detalles de implementación del ensamblado.

  • Representa el ensamblado como autodescriptivo.

Contenido del manifiesto del ensamblado

En la tabla siguiente se muestra la información contenida en el manifiesto del ensamblaje. Los cuatro primeros elementos (nombre del ensamblado, número de versión, referencia cultural e información sobre el nombre seguro) constituyen la identidad del ensamblado.

Información Descripción
Nombre del ensamblado Cadena de texto que especifica el nombre del ensamblado.
Número de versión Número de versión principal y secundaria, y número de revisión y de compilación. Common Language Runtime usa estos números para aplicar la directiva de versión.
Cultura Información sobre la referencia cultural o idioma que admite el ensamblado. Esta información solo debe usarse para designar un ensamblaje como un ensamblaje satélite que contenga información específica de la cultura o del idioma. (Se supone que un ensamblaje con información cultural es automáticamente un ensamblaje satélite).
Información sobre el nombre seguro Clave pública del editor si el ensamblado tiene un nombre seguro
Lista de todos los archivos del ensamblado Hash de cada archivo contenido en el ensamblado y un nombre de archivo. Tenga en cuenta que todos los archivos que componen el ensamblado deben estar en el mismo directorio que el archivo que contiene el manifiesto del ensamblado.
Información de referencia de tipos Información usada por el tiempo de ejecución para asignar una referencia de tipo al archivo que contiene su declaración e implementación. Se utiliza para tipos que se exportan desde el ensamblado.
Información sobre los ensamblados a los que se hace referencia Lista de otros ensamblados a los que hace referencia estáticamente el ensamblado. Cada referencia incluye el nombre del ensamblado dependiente, los metadatos del ensamblado (versión, referencia cultural, sistema operativo, etc.) y la clave pública, si el ensamblado tiene un nombre seguro.

Puede agregar o cambiar información en el manifiesto del ensamblado mediante atributos de ensamblado en el código. Puede cambiar la información de versión y los atributos informativos, como marcas comerciales, derechos de autor, producto, empresa e versión informativa. Para obtener una lista completa de los atributos de ensamblado, consulte Establecimiento de atributos de ensamblado.

Consulte también