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

A maioria dos atributos aplica-se a elementos específicos da linguagem, como classes ou métodos. No entanto, alguns atributos são globais. Aplicam-se a um conjunto ou módulo inteiro. Por exemplo, use o AssemblyVersionAttribute atributo para incorporar informação de versão numa assembly, assim:

[assembly: AssemblyVersion("1.0.0.0")]

Os atributos globais aparecem no código-fonte após quaisquer diretivas de nível using superior e antes de qualquer tipo, módulo ou declaração de namespace. Pode incluir atributos globais em vários ficheiros fonte, mas deve compilar os ficheiros numa única passagem de compilação. Nos projetos .NET Framework, o Visual Studio adiciona atributos globais ao ficheiro AssemblyInfo.cs. Esses atributos não são adicionados aos projetos .NET Core.

A referência da linguagem C# documenta a versão mais recentemente lançada da linguagem C#. Contém também documentação inicial para funcionalidades em pré-visualizações públicas para o próximo lançamento linguístico.

A documentação identifica qualquer funcionalidade introduzida pela primeira vez nas últimas três versões da língua ou em pré-visualizações públicas atuais.

Sugestão

Para saber quando uma funcionalidade foi introduzida pela primeira vez em C#, consulte o artigo sobre o histórico de versões da linguagem C#.

Os atributos da assembleia fornecem informação sobre uma assembleia. Enquadram-se nas seguintes categorias:

• Atributos de identidade do assembly
• Atributos informativos
• Atributos do 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 quando você faz referência a ele no código. Podes definir a versão e a cultura de uma assembleia usando atributos. No entanto, defines o valor do nome pelo compilador, pelo IDE Visual Studio na Caixa de Diálogo de Informação de Assembly, ou pelo Assembly Linker (Al.exe) quando crias o assembly. O nome do assembly é baseado no manifesto do assembly. O AssemblyFlagsAttribute atributo especifica se várias cópias do assembly podem coexistir.

A tabela a seguir mostra os atributos de identidade.

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

Atributos informativos

Use atributos informativos para fornecer mais informações sobre empresas ou produtos para uma montagem. A tabela a seguir mostra os atributos informativos definidos no System.Reflection namespace.

Atributo	Propósito
AssemblyProductAttribute	Especifica um nome de produto para um manifesto de assembly.
AssemblyTrademarkAttribute	Especifica uma marca comercial para um manifesto de assembly.
AssemblyInformationalVersionAttribute	Especifica uma versão informativa para um manifesto de assembly.
AssemblyCompanyAttribute	Especifica um nome de empresa para um manifesto de assembly.
AssemblyCopyrightAttribute	Define um atributo personalizado que especifica um copyright para um manifesto de 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 é compatível com a Common Language Specification (CLS).

Atributos do manifesto do assembly

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

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