Definir atributos do assembly no código

  • Artigo

Os atributos de assembly são valores que fornecem informações sobre um assembly. Geralmente, eles são definidos em um arquivo AssemblyInfo.cs. Os atributos são divididos nos seguintes conjuntos de informações:

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

Este artigo abrange a adição de atributos de assembly do código. Para obter informações sobre como adicionar atributos do assembly a projetos (não no código), consulte Definir atributos do assembly em um arquivo de projeto.

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 ao assembly no código. Você pode usar atributos para definir a versão e a cultura de um assembly. O compilador ou o Assembly Linker (Al.exe) define o valor do nome quando o assembly é criado, com base no arquivo que contém o manifesto do assembly.

A tabela a seguir descreve os atributos de versão e cultura.

Atributo de identidade do assembly Descrição
AssemblyCultureAttribute Campo enumerado que indica a cultura compatível com o assembly. Um assembly também pode especificar a independência da cultura, indicando que ela contém os recursos para a cultura padrão. Observação: o runtime trata qualquer assembly que não tenha o atributo de cultura definido como nulo, como um assembly satélite. Esses assemblies estão sujeitos às regras de associação de assembly satélite. Para saber mais, confira Como o runtime localiza assemblies.
AssemblyFlagsAttribute O valor que define os atributos de assembly; por exemplo, se o assembly pode ser executado lado a lado.
AssemblyVersionAttribute Valor numérico no formato principal.secundário.compilação.revisão (por exemplo, 2.4.0.0). O Common Language Runtime usa esse valor para executar operações de associação em assemblies com nome forte. Observação: se o atributo AssemblyInformationalVersionAttribute não for aplicado a um assembly, o número de versão especificado pelo atributo AssemblyVersionAttribute será usado pelas propriedades Application.ProductVersion, Application.UserAppDataPath e Application.UserAppDataRegistry.

O exemplo de código a seguir mostra como aplicar os atributos de versão e cultura a um 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 informativos

Você pode usar atributos informativos para fornecer informações adicionais corporativas ou de produto para um assembly. A tabela a seguir descreve os atributos informativos que você pode aplicar a um assembly.

Atributos informativos Descrição
AssemblyCompanyAttribute O valor de cadeia de caracteres que especifica um nome de empresa.
AssemblyCopyrightAttribute O valor de cadeia de caracteres que especifica informações sobre direitos autorais.
AssemblyFileVersionAttribute O valor de cadeia de caracteres que especifica o número de versão do arquivo Win32. Isso normalmente tem como padrão a versão do assembly.
AssemblyInformationalVersionAttribute O valor de cadeia de caracteres que especifica informações de versão que não são usadas pelo Common Language Runtime, como o número de versão completo de um produto. Observação: se esse atributo for aplicado a um assembly, a cadeia de caracteres que ele especifica poderá ser obtida em tempo de execução usando a propriedade Application.ProductVersion. A cadeia de caracteres também é usada na chave do Registro e no caminho fornecidos pelas propriedades Application.UserAppDataPath e Application.UserAppDataRegistry.
AssemblyProductAttribute O valor de cadeia de caracteres que especifica informações do produto.
AssemblyTrademarkAttribute O valor de cadeia de caracteres que especifica informações de marca registrada.

Esses atributos podem aparecer na página Propriedades do Windows do assembly ou podem ser substituídos usando a opção de compilador /win32res para especificar seu arquivo de recurso Win32.

Atributos de manifesto do assembly

Também é possível usar atributos de manifesto do assembly para fornecer informações no manifesto do assembly, incluindo título, descrição, o alias padrão e a configuração. A tabela a seguir descreve os atributos de manifesto do assembly.

Atributo de manifesto do assembly Descrição
AssemblyConfigurationAttribute O valor de cadeia de caracteres que indica a configuração do assembly, como Retail ou Depuração. O runtime não usa esse valor.
AssemblyDefaultAliasAttribute O valor de cadeia de caracteres que especifica um alias padrão a ser usado ao fazer referências de assemblies. Esse valor fornece um nome amigável quando o nome do assembly em si não o for (como um valor GUID). Esse valor também pode ser usado como uma forma abreviada do nome completo do assembly.
AssemblyDescriptionAttribute O valor de cadeia de caracteres que especifica uma breve descrição que resume a natureza e o objetivo do assembly.
AssemblyTitleAttribute O valor de cadeia de caracteres que especifica um nome amigável para o assembly. Por exemplo, um assembly nomeado como comdlg pode ter o título Controle de Diálogo Comum da Microsoft.

Atributos de nome forte

Você pode usar atributos de nome forte para definir um nome forte para um assembly. A tabela a seguir descreve os atributos de nome forte.

Atributo de nome forte Descrição
AssemblyDelaySignAttribute O valor booliano que indica que a assinatura em atraso está sendo usada.
AssemblyKeyFileAttribute O valor de cadeia de caracteres que indica o nome do arquivo que contém a chave pública (se usando assinatura em atraso) ou as chaves pública e privada passadas como um parâmetro ao construtor desse atributo. Observe que o nome de arquivo é relativo ao caminho do arquivo de saída (o .exe or .dll), e não ao caminho do arquivo de origem.
AssemblyKeyNameAttribute Indica o contêiner de chaves que contém o par de chaves passado como um parâmetro ao construtor desse atributo.

O exemplo de código a seguir mostra os atributos que se aplicam ao usar a assinatura em atraso para criar um assembly de nome forte com um arquivo de chave pública chamado myKey.snk.

[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];

[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]

<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>

Confira também