Atributos de nivel de ensamblado interpretados por el compilador de C#

La mayoría de los atributos se aplican a elementos de lenguaje específicos, como clases o métodos. Sin embargo, algunos atributos son globales. Se aplican a todo un ensamblado o módulo. Por ejemplo, use el AssemblyVersionAttribute atributo para insertar información de versión en un ensamblado, de la siguiente manera:

[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. Puede incluir atributos globales en varios archivos de origen, pero debe compilar los archivos en un solo paso de compilación. En los proyectos de .NET Framework, Visual Studio agrega atributos globales al archivo AssemblyInfo.cs. Estos atributos no se agregan a los proyectos de .NET Core.

La referencia del lenguaje C# documenta la versión publicada más recientemente del lenguaje C#. También contiene documentación inicial sobre las características de las versiones preliminares públicas de la próxima versión del lenguaje.

La documentación identifica cualquier característica introducida por primera vez en las últimas tres versiones del idioma o en las versiones preliminares públicas actuales.

Sugerencia

Para buscar cuándo se introdujo por primera vez una característica en C#, consulte el artículo sobre el historial de versiones del lenguaje C#.

Los atributos de ensamblado 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. Sin embargo, el compilador establece el valor de nombre, el IDE de Visual Studio en el cuadro de diálogo Información de ensamblado o el enlazador de ensamblados (Al.exe) al crear 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

Use atributos informativos para proporcionar más información de empresa o 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

Use atributos de manifiesto de 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 predeterminado descriptivo para un manifiesto de ensamblado.