Manifiesto del ensambladoAssembly Manifest

Todos los ensamblados, ya sean estáticos o dinámicos, contienen una colección de datos que describen cómo se relacionan entre sí los elementos del ensamblado.Every assembly, whether static or dynamic, contains a collection of data that describes how the elements in the assembly relate to each other. El manifiesto contiene estos metadatos del ensamblado.The assembly manifest contains this assembly metadata. Un manifiesto del 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 los recursos y las clases.An assembly manifest contains all the metadata needed to specify the assembly's version requirements and security identity, and all metadata needed to define the scope of the assembly and resolve references to resources and classes. El manifiesto del ensamblado se puede almacenar en un archivo PE (.exe o .dll) con código de lenguaje intermedio de Microsoft (MSIL) o en un archivo PE independiente que contenga sólo la información sobre el manifiesto del ensamblado.The assembly manifest can be stored in either a PE file (an .exe or .dll) with Microsoft intermediate language (MSIL) code or in a standalone PE file that contains only assembly manifest information.

En la siguiente ilustración se muestran las distintas formas de almacenar un manifiesto.The following illustration shows the different ways the manifest can be stored.

Diagrama en el que se muestra el manifiesto de una configuración de ensamblado de un solo archivo y de múltiples archivos.

En el caso de un ensamblado que tenga un solo archivo asociado, el manifiesto se incluye en el archivo PE para formar un ensamblado de un solo archivo.For an assembly with one associated file, the manifest is incorporated into the PE file to form a single-file assembly. Se puede crear un ensamblado de múltiples archivos con un archivo de manifiesto independiente o incorporando el manifiesto en uno de los archivos PE del ensamblado.You can create a multifile assembly with a standalone manifest file or with the manifest incorporated into one of the PE files in the assembly.

Un manifiesto de ensamblado realiza las funciones siguientes:Each assembly's manifest performs the following functions:

  • Enumera los archivos que componen el ensamblado.Enumerates the files that make up the assembly.

  • Controla cómo se asignan las referencias a los tipos y recursos del ensamblado a los archivos que contienen sus declaraciones e implementaciones.Governs how references to the assembly's types and resources map to the files that contain their declarations and implementations.

  • Enumera otros ensamblados de los que depende este ensamblado.Enumerates other assemblies on which the assembly depends.

  • Proporciona un nivel de direccionamiento indirecto entre los consumidores del ensamblado y los detalles de implementación del ensamblado.Provides a level of indirection between consumers of the assembly and the assembly's implementation details.

  • Representa el ensamblado como autodescriptivo.Renders the assembly self-describing.

Contenido del manifiesto del ensambladoAssembly Manifest Contents

En la tabla siguiente, se muestra la información que contiene el manifiesto del ensamblado.The following table shows the information contained in the assembly manifest. 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.The first four items—the assembly name, version number, culture, and strong name information—make up the assembly's identity.

InformaciónInformation DescripciónDescription
Nombre del ensambladoAssembly name Cadena de texto donde se especifica el nombre del ensamblado.A text string specifying the assembly's name.
Número de versiónVersion number Número de versión principal y secundaria, y número de revisión y de compilación.A major and minor version number, and a revision and build number. Common Language Runtime utiliza estos números para exigir las directivas de versión.The common language runtime uses these numbers to enforce version policy.
cultureCulture Información sobre la referencia cultural o idioma que admite el ensamblado.Information on the culture or language the assembly supports. Esta información se debe utilizar sólo para designar un ensamblado como ensamblado satélite que contiene información específica sobre la referencia cultural o el idioma.This information should be used only to designate an assembly as a satellite assembly containing culture- or language-specific information. (Se asume que un ensamblado con información de referencia cultural es un ensamblado satélite).(An assembly with culture information is automatically assumed to be a satellite assembly.)
Información sobre el nombre seguroStrong name information Clave pública del editor si el ensamblado tiene un nombre seguroThe public key from the publisher if the assembly has been given a strong name.
Lista de todos los archivos del ensambladoList of all files in the assembly Un código hash de cada archivo que contiene el ensamblado y nombre de archivo .A hash of each file contained in the assembly and a file name. Tenga en cuenta que todos los archivos que componen el ensamblado deben encontrarse en el mismo directorio que el archivo que contiene el manifiesto del ensamblado.Note that all files that make up the assembly must be in the same directory as the file containing the assembly manifest.
Información de referencia de tiposType reference information Información que utiliza el motor en tiempo de ejecución para asignar una referencia de tipos al archivo que contiene su declaración e implementación.Information used by the runtime to map a type reference to the file that contains its declaration and implementation. Se utiliza para tipos que se exportan desde el ensamblado.This is used for types that are exported from the assembly.
Información sobre ensamblados a los que se hace referenciaInformation on referenced assemblies Lista de otros ensamblados a los que este ensamblado hace referencia estáticamente.A list of other assemblies that are statically referenced by the assembly. 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.Each reference includes the dependent assembly's name, assembly metadata (version, culture, operating system, and so on), and public key, if the assembly is strong named.

Si desea agregar o modificar información en el manifiesto del ensamblado, puede utilizar atributos de ensamblado en su código.You can add or change some information in the assembly manifest by using assembly attributes in your code. Se puede cambiar la información de versión y los atributos informativos, como Trademark, Copyright, Product, Company e Informational Version.You can change version information and informational attributes, including Trademark, Copyright, Product, Company, and Informational Version. Para obtener una lista completa de los atributos de ensamblado, vea Setting Assembly Attributes (Establecer atributos de ensamblado).For a complete list of assembly attributes, see Setting Assembly Attributes.

Vea tambiénSee also