Configurar atributos de ensambladosSetting Assembly Attributes

Los atributos de ensamblado son valores que proporcionan información sobre un ensamblado.Assembly attributes are values that provide information about an assembly. Los atributos se dividen en los siguientes conjuntos de información:The attributes are divided into the following sets of information:

  • Atributos de identidad del ensamblado.Assembly identity attributes.

  • Atributos informativos.Informational attributes.

  • Atributos de manifiesto del ensamblado.Assembly manifest attributes.

  • Atributos de nombre seguro.Strong name attributes.

Atributos de identidad del ensambladoAssembly Identity Attributes

Tres atributos, junto con un nombre seguro (si procede), determinan la identidad de un ensamblado: nombre, versión y referencia cultural.Three attributes, together with a strong name (if applicable), determine the identity of an assembly: name, version, and culture. Estos atributos forman el nombre completo del ensamblado y son necesarios cuando se hace referencia el ensamblado en el código.These attributes form the full name of the assembly and are required when referencing the assembly in code. Puede usar atributos para establecer la versión y la referencia cultural de un ensamblado.You can use attributes to set an assembly's version and culture. 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.The compiler or the Assembly Linker (Al.exe) sets the name value when the assembly is created, based on the file containing the assembly manifest.

En la tabla siguiente se describen los atributos de versión y de referencia cultural.The following table describes the version and culture attributes.

Atributo de identidad del ensambladoAssembly identity attribute DescriptionDescription
AssemblyCultureAttribute Campo enumerado que indica la referencia cultural que admite el ensamblado.Enumerated field indicating the culture that the assembly supports. Un ensamblado también puede especificar independencia de la referencia cultural, lo que indica que contiene los recursos para la referencia cultural predeterminada.An assembly can also specify culture independence, indicating that it contains the resources for the default culture. Nota: El tiempo de ejecución trata cualquier ensamblado que no tenga el atributo de referencia cultural establecido en NULL como un ensamblado satélite.Note: The runtime treats any assembly that does not have the culture attribute set to null as a satellite assembly. Estos ensamblados están sujetos a las reglas de enlace de ensamblados satélite.Such assemblies are subject to satellite assembly binding rules. Para más información, consulte Cómo ubica ensamblados el tiempo de ejecución.For more information, see How the Runtime Locates Assemblies.
AssemblyFlagsAttribute Valor que establece atributos de ensamblado, como por ejemplo, si se puede ejecutar el ensamblado en paralelo.Value that sets assembly attributes, such as whether the assembly can be run side by side.
AssemblyVersionAttribute Valor numérico con el formato versión_principal.versión_secundaria.compilación.revisión (por ejemplo, 2.4.0.0).Numeric value in the format major.minor.build.revision (for example, 2.4.0.0). Common Language Runtime usa este valor para realizar operaciones de enlace en ensamblados con nombre seguro.The common language runtime uses this value to perform binding operations in strong-named assemblies. Nota: Si el atributo AssemblyInformationalVersionAttribute no se aplica a un ensamblado, el número de versión que especifica el atributo AssemblyVersionAttribute lo usan las propiedades Application.ProductVersion, Application.UserAppDataPath y Application.UserAppDataRegistry.Note: If the AssemblyInformationalVersionAttribute attribute is not applied to an assembly, the version number specified by the AssemblyVersionAttribute attribute is used by the Application.ProductVersion, Application.UserAppDataPath, and Application.UserAppDataRegistry properties.

En el ejemplo de código siguiente se muestra cómo aplicar los atributos de versión y referencia cultural a un ensamblado.The following code example shows how to apply the version and culture attributes to an assembly.

// 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 informativosInformational Attributes

Puede utilizar atributos informativos para proporcionar información adicional de la compañía o de producto para un ensamblado.You can use informational attributes to provide additional company or product information for an assembly. En la tabla siguiente se describen los atributos informativos que se pueden aplicar a un ensamblado.The following table describes the informational attributes you can apply to an assembly.

Atributo informativoInformational attribute DescriptionDescription
AssemblyCompanyAttribute Valor de cadena que especifica un nombre de compañía.String value specifying a company name.
AssemblyCopyrightAttribute Valor de cadena que especifica información de copyright.String value specifying copyright information.
AssemblyFileVersionAttribute Valor de cadena que especifica el número de versión del archivo Win32.String value specifying the Win32 file version number. Normalmente el valor predeterminado es la versión del ensamblado.This normally defaults to the assembly version.
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.String value specifying version information that is not used by the common language runtime, such as a full product version number. Nota: 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.Note: If this attribute is applied to an assembly, the string it specifies can be obtained at run time by using the Application.ProductVersion property. La cadena también se usa en la clave del Registro y la ruta de acceso que proporcionan las propiedades Application.UserAppDataPath y Application.UserAppDataRegistry.The string is also used in the path and registry key provided by the Application.UserAppDataPath and Application.UserAppDataRegistry properties.
AssemblyProductAttribute Valor de cadena que especifica la información del producto.String value specifying product information.
AssemblyTrademarkAttribute Valor de cadena que especifica la información de marca comercial.String value specifying trademark information.

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.These attributes can appear on the Windows Properties page of the assembly, or they can be overridden using the /win32res compiler option to specify your own Win32 resource file.

Atributos de manifiesto del ensambladoAssembly Manifest Attributes

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.You can use assembly manifest attributes to provide information in the assembly manifest, including title, description, the default alias, and configuration. En la tabla siguiente se describen los atributos de manifiesto del ensamblado.The following table describes the assembly manifest attributes.

Atributo de manifiesto del ensambladoAssembly manifest attribute DescriptionDescription
AssemblyConfigurationAttribute Valor de cadena que indica la configuración del ensamblado, como Retail o Debug.String value indicating the configuration of the assembly, such as Retail or Debug. El tiempo de ejecución no utiliza este valor.The runtime does not use this value.
AssemblyDefaultAliasAttribute Valor de cadena que especifica un alias predeterminado que utilizarán los ensamblados de referencia.String value specifying a default alias to be used by referencing assemblies. Este valor proporciona un nombre descriptivo cuando el nombre del ensamblado no es descriptivo por sí solo (por ejemplo, un valor GUID).This value provides a friendly name when the name of the assembly itself is not friendly (such as a GUID value). Este valor también puede utilizarse como una forma abreviada del nombre completo del ensamblado.This value can also be used as a short form of the full assembly name.
AssemblyDescriptionAttribute Valor de cadena que especifica una breve descripción que resume la naturaleza y el propósito del ensamblado.String value specifying a short description that summarizes the nature and purpose of the assembly.
AssemblyTitleAttribute Valor de cadena que especifica un nombre descriptivo para el ensamblado.String value specifying a friendly name for the assembly. Por ejemplo, un ensamblado denominado comdlg puede tener el título Microsoft Common Dialog Control.For example, an assembly named comdlg might have the title Microsoft Common Dialog Control.

Atributos de nombre seguroStrong Name Attributes

Puede utilizar atributos de nombre seguro para establecer un nombre seguro para un ensamblado.You can use strong name attributes to set a strong name for an assembly. En la tabla siguiente se describen los atributos de nombre seguro.The following table describes the strong name attributes.

Atributos de nombre seguroStrong name attributes DescriptionDescription
AssemblyDelaySignAttribute Valor booleano que indica que se está usando la firma retardada.Boolean value indicating that delay signing is being used.
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.String value indicating the name of the file that contains either the public key (if using delay signing) or both the public and private keys passed as a parameter to the constructor of this attribute. 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.Note that the file name is relative to the output file path (the .exe or .dll), not the source file path.
AssemblyKeyNameAttribute Indica el contenedor de claves que contiene el par de claves que se pasa como parámetro al constructor de este atributo.Indicates the key container that contains the key pair passed as a parameter to the constructor of this attribute.

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.The following code example shows the attributes to apply when using delay signing to create a strong-named assembly with a public key file called 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énSee Also

Creación de ensambladosCreating Assemblies
Programar con ensambladosProgramming with Assemblies