Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés

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 de nombre seguro.

Tres atributos, junto con un nombre seguro (si procede), determinan la identidad de un ensamblado: nombre, versión y referencia cultural. Estos atributos forman el nombre completo del ensamblado y son necesarios cuando se hace referencia el ensamblado en el código. Puede usar atributos para establecer la versión y la referencia cultural de un ensamblado. El compilador o el Assembly Linker (Al.exe) establecen 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 de referencia cultural.

Atributo de identidad del ensamblado

Descripción

AssemblyCultureAttribute

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

System_CAPS_noteNota

El tiempo de ejecución trata cualquier ensamblado que no tenga el atributo de referencia cultural establecido en NULL como un ensamblado satélite. Estos ensamblados están sujetos a las reglas de enlace de ensamblados satélite. Para obtener más información, véase Novedades en el SDK Visual Studio 2015.

AssemblyFlagsAttribute

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

AssemblyVersionAttribute

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

System_CAPS_noteNota

Si el atributo AssemblyInformationalVersionAttribute no se aplica a un ensamblado, el número de versión que especifica el atributo AssemblyVersionAttribute lo utilizan las propiedades Application.ProductVersion, Application.UserAppDataPath y Application.UserAppDataRegistry.

En el ejemplo de código siguiente se muestra cómo aplicar 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")]

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

Atributo informativo

Descripción

AssemblyCompanyAttribute

Valor de cadena que especifica un nombre de compañía.

AssemblyCopyrightAttribute

Valor de cadena que especifica información de copyright.

AssemblyFileVersionAttribute

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

AssemblyInformationalVersionAttribute

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

System_CAPS_noteNota

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

AssemblyProductAttribute

Valor de cadena que especifica la información del producto.

AssemblyTrademarkAttribute

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

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

Puede utilizar atributos de manifiesto del ensamblado para proporcionar información en el manifiesto del ensamblado, incluidos el título, la 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, como Retail o Debug. El tiempo de ejecución no utiliza este valor.

AssemblyDefaultAliasAttribute

Valor de cadena que especifica un alias predeterminado que utilizarán los ensamblados de referencia. Este valor proporciona un nombre descriptivo cuando el nombre del ensamblado no es descriptivo por sí solo (por ejemplo, un valor GUID). Este valor también puede utilizarse como una forma abreviada del nombre completo del ensamblado.

AssemblyDescriptionAttribute

Valor de cadena que especifica una breve descripción que resume la naturaleza y el propósito 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 Microsoft Common Dialog Control.

Puede utilizar atributos de nombre seguro para establecer un nombre seguro para un ensamblado. En la tabla siguiente se describen los atributos de nombre seguro.

Atributos de nombre seguro

Descripción

AssemblyDelaySignAttribute

Valor booleano que indica que se está usando la firma retardada.

AssemblyKeyFileAttribute

Valor de cadena que indica el nombre del archivo que contiene la clave pública (si se usa la firma retardada) o las claves públicas y privadas que se pasan como un parámetro al constructor de este atributo. Tenga en cuenta que el nombre de archivo es relativo a la ruta de acceso del archivo de salida (.exe o .dll), no a la ruta de acceso del archivo de origen.

AssemblyKeyNameAttribute

Indica el contenedor de claves que contiene el par de claves que se pasa como parámetro al constructor de este atributo.

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

[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]
Mostrar: