Atributos de nível de assembly interpretados pelo compilador C#

A maioria dos atributos são aplicados aos elementos específicos de linguagem, como classes ou métodos. No entanto, alguns atributos são globais. Eles se aplicam a um assembly inteiro ou módulo. Por exemplo, o atributo AssemblyVersionAttribute pode ser usado para inserir informações de versão em um assembly, desta maneira:

[assembly: AssemblyVersion("1.0.0.0")]

Os atributos globais aparecem no código-fonte depois de qualquer diretiva using de nível superior e antes de qualquer declaração de namespace, de módulo ou de tipo. Os atributos globais podem aparecer em vários arquivos de origem, mas os arquivos devem ser compilados em uma única passagem de compilação. O Visual Studio adiciona atributos globais ao arquivo AssemblyInfo.cs em projetos do .NET Framework. Esses atributos não são adicionados a projetos do .NET Core.

Os atributos de assembly são valores que fornecem informações sobre um assembly. Eles se enquadram nas seguintes categorias:

• Atributos de identidade do assembly
• Atributos informativos
• Atributos de manifesto do assembly

Atributos de identidade do assembly

Três atributos (com um nome forte, se aplicável) determinam a identidade de um assembly: nome, versão e cultura. Esses atributos formam o nome completo do assembly e são necessários ao fazer referência a ele no código. Você pode definir a versão e a cultura de um assembly, usando atributos. No entanto, o valor do nome é definido pelo compilador, pelo Visual Studio IDE na caixa de diálogo Informações do Assembly ou pelo vinculador do assembly (Al.exe) quando o assembly é criado. O nome do assembly é baseado no manifesto do assembly. O atributo AssemblyFlagsAttribute especifica se várias cópias do assembly podem coexistir.

A tabela a seguir mostra os atributos de identidade.

Atributo	Finalidade
AssemblyVersionAttribute	Especifica a versão de um assembly.
AssemblyCultureAttribute	Especifica a qual cultura o assembly dá suporte.
AssemblyFlagsAttribute	Especifica uma combinação bit a bit dos sinalizadores para um assembly, descrevendo as opções do compilador JIT (just-in-time), se o assembly é ou não redirecionável e se ele tem uma chave pública completa ou indexada.

Atributos informativos

Você usa atributos informativos para fornecer informações adicionais da empresa ou do produto para um assembly. A tabela a seguir mostra os atributos informativos definidos no namespace System.Reflection.

Atributo	Finalidade
AssemblyProductAttribute	Especifica um nome de produto para um manifesto do assembly.
AssemblyTrademarkAttribute	Especifica uma marca para um manifesto do assembly.
AssemblyInformationalVersionAttribute	Especifica uma versão informativa para um manifesto do assembly.
AssemblyCompanyAttribute	Especifica um nome de empresa para um manifesto do assembly.
AssemblyCopyrightAttribute	Define um atributo personalizado que especifica os direitos autorais para um manifesto do assembly.
AssemblyFileVersionAttribute	Define um número de versão específico para o recurso de versão do arquivo Win32.
CLSCompliantAttribute	Indica se o assembly está em conformidade com a CLS (Common Language Specification).

Atributos de manifesto do assembly

Você pode usar atributos de manifesto do assembly para fornecer informações no manifesto do assembly. Os atributos incluem título, descrição, alias padrão e configuração. A tabela a seguir mostra os atributos de manifesto do assembly definidos no namespace System.Reflection.

Atributo	Finalidade
AssemblyTitleAttribute	Especifica um título de assembly para um manifesto do assembly.
AssemblyDescriptionAttribute	Especifica uma descrição do assembly para um manifesto do assembly.
AssemblyConfigurationAttribute	Especifica uma configuração de assembly (como varejo ou depuração) para um manifesto do assembly.
AssemblyDefaultAliasAttribute	Define um alias amigável padrão para um manifesto do assembly