Atributos de nivel de ensamblado interpretados por el compilador de C#
La mayoría de los atributos se aplican a elementos específicos del lenguaje, como las clases o los métodos, aunque algunos atributos son globales (se aplican a todo un ensamblado o módulo). Por ejemplo, el atributo AssemblyVersionAttribute se puede usar para insertar información de versión en un ensamblado, como en este ejemplo:
[assembly: AssemblyVersion("1.0.0.0")]
Los atributos globales aparecen en el código fuente después de cualquier directiva using de nivel superior y antes de cualquier declaración de tipo, módulo o espacio de nombres. Los atributos globales pueden aparecer en varios archivos de código fuente, pero estos archivos se deben compilar en un solo paso de compilación. Visual Studio agrega atributos globales al archivo AssemblyInfo.cs en proyectos de .NET Framework. Estos atributos no se agregan a los proyectos de .NET Core.
Los atributos de ensamblado son valores que proporcionan información sobre un ensamblado. Se dividen en las siguientes categorías:
- Atributos de identidad del ensamblado
- Atributos informativos
- Atributos de manifiesto del ensamblado
Atributos de identidad del ensamblado
Tres atributos, 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 a este en el código. Puede establecer la versión y la referencia cultural de un ensamblado mediante atributos, pero el valor de nombre lo establece el compilador, el IDE de Visual Studio en el cuadro de diálogo de información de ensamblado o la herramienta Assembly Linker (Al.exe) cuando se crea el ensamblado. El nombre del ensamblado se basa en el manifiesto del ensamblado. El atributo AssemblyFlagsAttribute especifica si pueden coexistir varias copias del ensamblado.
En la siguiente tabla se muestran los atributos de identidad.
| Atributo | Propósito |
|---|---|
| AssemblyVersionAttribute | Especifica la versión de un ensamblado. |
| AssemblyCultureAttribute | Especifica la cultura que admite el ensamblado. |
| AssemblyFlagsAttribute | Especifica una combinación bit a bit de las marcas para un ensamblado, describiendo las opciones del compilador Just-In-Time (JIT), si se puede redestinar el ensamblado y si tiene una clave pública completa o acortada. |
Atributos informativos
Puede usar atributos informativos para proporcionar más información de la empresa o el producto para un ensamblado. En la tabla siguiente se muestran los atributos informativos definidos en el espacio de nombres System.Reflection.
| Atributo | Propósito |
|---|---|
| AssemblyProductAttribute | Especifica un nombre de producto para un manifiesto del ensamblado. |
| AssemblyTrademarkAttribute | Especifica una marca comercial para un manifiesto del ensamblado. |
| AssemblyInformationalVersionAttribute | Especifica una versión informativa para un manifiesto del ensamblado. |
| AssemblyCompanyAttribute | Especifica un nombre de empresa para un manifiesto del ensamblado. |
| AssemblyCopyrightAttribute | Define un atributo personalizado que especifica un copyright para un manifiesto del ensamblado. |
| AssemblyFileVersionAttribute | Establece un número de versión específico para el recurso de versión de archivo Win32. |
| CLSCompliantAttribute | Indica si el ensamblado es compatible con Common Language Specification (CLS). |
Atributos de manifiesto del ensamblado
Puede usar los atributos de manifiesto del ensamblado para proporcionar información en el manifiesto del ensamblado Los atributos incluyen el título, la descripción, el alias predeterminado y la configuración. En la tabla siguiente se muestran los atributos de manifiesto del ensamblado definidos en el espacio de nombres System.Reflection.
| Atributo | Propósito |
|---|---|
| AssemblyTitleAttribute | Especifica un título de ensamblado para un manifiesto del ensamblado. |
| AssemblyDescriptionAttribute | Especifica una descripción de ensamblado para un manifiesto del ensamblado. |
| AssemblyConfigurationAttribute | Especifica una configuración de ensamblado (por ejemplo, comercial o depuración) para un manifiesto del ensamblado. |
| AssemblyDefaultAliasAttribute | Define un alias descriptivo predeterminado para un manifiesto del ensamblado. |
