Compartir a través de


Configurar atributos de ensamblados

Los atributos de ensamblado son valores que proporcionan información sobre un ensamblado. Los atributos se dividen en los siguientes conjuntos de información:

  • Atributos de identidad del ensamblado.

  • Atributos informativos.

  • Atributos de manifiesto del ensamblado.

  • Atributos del nombre seguro

Atributos de identidad del ensamblado

Estos atributos, junto con un nombre seguro (si lo hay), determinan la identidad de un ensamblado: nombre, versión y referencia cultural. Estos atributos forman el nombre completo del ensamblado y son necesarios para hacer referencia al ensamblado en el código. Estos atributos se pueden usar para establecer la versión y la referencia cultural de un ensamblado. El compilador o la herramienta Assembly Linker (Al.exe) establece el valor de nombre cuando se crea el ensamblado, basándose en el archivo que contiene el manifiesto del ensamblado.

En la tabla siguiente se describen los atributos de versión y referencia cultural.

Atributo de identidad del ensamblado

Descripción

AssemblyCultureAttribute

Campo numerado que indica la referencia cultural que admite el ensamblado. En un ensamblado se puede especificar también independencia de referencia cultural, lo que indica que contiene los recursos para la referencia cultural predeterminada.

NotaNota
El motor en tiempo de ejecución trata a los ensamblados que no tienen el atributo de referencia cultural establecido en null como ensamblado satélite.Estos ensamblados están sometidos a las reglas de enlace de ensamblado satélite.Para obtener más información, vea Cómo el motor en tiempo de ejecución ubica ensamblados.

AssemblyFlagsAttribute

Valor que establece atributos del ensamblado, por ejemplo si el ensamblado se puede ejecutar de forma en paralelo. 

AssemblyVersionAttribute

Valor numérico con el formato principal.secundario.compilación.revisión (por ejemplo, 2.4.0.0). Common Language Runtime usa este valor para realizar operaciones de enlace en ensamblados de nombre seguro.

NotaNota
Si el atributo AssemblyInformationalVersionAttribute no se aplica a un ensamblado, las propiedades Application.ProductVersion, Application.UserAppDataPath y Application.UserAppDataRegistry usan el número de versión especificado por el atributo AssemblyVersionAttribute.

En el siguiente ejemplo de código se muestra cómo se aplican los atributos de versión y referencia cultural a un ensamblado.

' Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
' Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>
// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")]
// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")];
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")];

Atributos informativos

Los atributos informativos se pueden usar para proporcionar información adicional del producto o de la compañía sobre un ensamblado. En la siguiente tabla se describen los atributos informativos que se pueden aplicar a un ensamblado.

Atributo informativo

Descripción

AssemblyCompanyAttribute

Valor de cadena que especifica el nombre de una compañía.

AssemblyCopyrightAttribute

Valor de cadena que especifica la información de copyright.

AssemblyFileVersionAttribute

Valor de cadena que especifica el número de versión del archivo Win32. Normalmente, toma como valor predeterminado la versión del ensamblado.

AssemblyInformationalVersionAttribute

Valor de cadena que especifica información de versión que no usa Common Language Runtime, como por ejemplo, un número completo de versión del producto.

NotaNota
Si este atributo se aplica a un ensamblado, la cadena que especifica puede obtenerse en tiempo de ejecución utilizando la propiedad Application.ProductVersion.La cadena también se utiliza en la ruta de acceso y la clave del Registro proporcionada por las propiedades Application.UserAppDataRegistry y Application.UserAppDataPath.

AssemblyProductAttribute

Valor de cadena que especifica información del producto.

AssemblyTrademarkAttribute

Valor de cadena que especifica información de marca comercial.

Estos atributos pueden aparecer en la página de propiedades de Windows del ensamblado, o se pueden sobrescribir con la opción de compilador /win32res para especificar un archivo de recursos de Win32 propio.

Atributos de manifiesto del ensamblado

Los atributos de manifiesto del ensamblado se puede usar para proporcionar información del manifiesto del ensamblado, como título, descripción, el alias predeterminado y la configuración. En la tabla siguiente se describen los atributos de manifiesto del ensamblado.

Atributo de manifiesto del ensamblado

Descripción

AssemblyConfigurationAttribute

Valor de cadena que indica la configuración del ensamblado, por ejemplo si se trata de lanzamiento o de depuración . El motor en tiempo de ejecución no utiliza este valor.

AssemblyDefaultAliasAttribute

Valor de cadena que indica el alias predeterminado que utilizarán los ensamblados que hacen referencia. Este valor proporciona un nombre descriptivo si el nombre del ensamblado no lo es (por ejemplo, un valor GUID). Este valor se puede usar también como nombre breve del nombre completo del ensamblado.

AssemblyDescriptionAttribute

Valor de cadena que ofrece una breve descripción que resume la naturaleza y objetivos del ensamblado.

AssemblyTitleAttribute

Valor de cadena que especifica un nombre descriptivo para el ensamblado. Por ejemplo, un ensamblado denominado comdlg puede tener el título de Microsoft Common Dialog Control.

Atributos del nombre seguro

Los atributos del nombre seguro se pueden usar para establecer un nombre seguro para un ensamblado. En la tabla siguiente se describen los atributos del nombre seguro.

Atributos del nombre seguro

Descripción

AssemblyDelaySignAttribute

Valor booleano que indica que se va a retrasar la firma del ensamblado.

AssemblyKeyFileAttribute

Valor de cadena que indica el nombre del archivo que contiene una clave pública (si se usa retraso de firma) o tanto la clave pública como la privada que se pasan como parámetros al constructor de este atributo. Tenga en cuenta que nombre de archivo es relativo respecto a la ruta de acceso del archivo de salida (.exe o .dll), no a la del archivo de código fuente.

AssemblyKeyNameAttribute

Especifica el contenedor de claves en que se encuentra el par de claves que se pasa como parámetro al constructor de este atributo.

En el siguiente ejemplo de código se muestran los atributos que se han de aplicar cuando se usa la firma retrasada para crear un ensamblado con nombre seguro y con un archivo de clave pública denominado myKey.snk.

<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>
[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]
[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];

Vea también

Conceptos

Crear ensamblados

Otros recursos

Programar con ensamblados