Definindo os Atributos de Assembly
Atributos de Conjunto de Módulos (Assembly) são valores que fornecem informações sobre um conjunto.Os atributos são divididos nos seguintes conjuntos de informações:
Atributos de identidade de Assembly
Atributos Informativos
Atributos do manifesto do assembly
Atributos de nome de alta segurança
Atributos de identidade de Assembly
Três atributos, juntamente com um nome forte (se aplicável), determinar a identidade de um assembly: nome, versão e cultura.Esses atributos formam o nome completo do conjunto e são necessários quando você faz referência a ele no código.Você pode usar atributos para definir versão e cultura de um conjunto de módulos.O compilador ou o Assembly Linker (AL.exe) define o valor do nome quando o conjunto é criado, com base no arquivo que contém o manifesto do assembly.
A tabela a seguir descreve os atributos de versão e cultura.
Atributos de identidade de Assembly |
Descrição |
|---|---|
Campo enumerado que indica a cultura que o conjunta suporta.Um conjunto também pode especificar independência da cultura, indicando que ele contém os recursos para a cultura padrão. .gif "Observação") Observação:
O tempo de execução trata qualquer conjunto que não tenha o atributo de cultura definido como nulo como um assembly satélite.Esses conjuntos de módulos (assemblies) são sujeitos as regras de ligação dos conjuntos satélites.Para obter mais informações, consulte Como o tempo de execução Localiza Assemblies.
|
|
Valor que define os atributos Assembly, como se o assembly pode ser executado lado a lado. |
|
Valor numérico no formato principais.secundária.compilação.revisão (por exemplo, 2.4.0.0).O Common Language Runtime utiliza esse valor para executar operações de vinculação em conjuntos de nome de alta segurança. Observação:
Se a AssemblyInformationalVersionAttribute atributo não é aplicado a um assembly, o número da versão especificado pela AssemblyVersionAttribute atributo é usado pela Application.ProductVersion, Application.UserAppDataPath, e Application.UserAppDataRegistry Propriedades.
|
O exemplo de código a seguir mostra como aplicar os atributos de versão e de cultura a um conjunto de módulos (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")]
Atributos Informativos
Você pode usar atributos informativos para fornecer informações adicionais sobre empresas ou produtos para um conjunto de módulos (assembly).A tabela a seguir descreve os atributos informativos que você pode aplicar a um conjunto de módulos (assembly).
Atributos Informativos |
Descrição |
|---|---|
Valor de sequência de caracteres especifica o nome da empresa. |
|
Valor de sequência de caracteres especificando as informações sobre direitos autorais. |
|
Valor de sequência de caracteres especificando o número de versão do arquivo Win32.Isso normalmente padrozina de acordo com a versão do conjunto. |
|
Especificar sistema autônomo informações de versão não são usadas pelo common linguagem tempo de execução, sistema autônomo um número de versão completa do produto do valor de seqüência de caracteres. Observação:
Se esse atributo é aplicado a um assembly, ele especifica a seqüência de caracteres pode ser obtida em time de execução usando o Application.ProductVersion propriedade. A seqüência de caracteres também será usada na chave do registro e o caminho fornecido pelo Application.UserAppDataPath e Application.UserAppDataRegistry Propriedades.
|
|
Valor sequência de caracteres especificando informações do produto. |
|
Valor sequência de caracteres especificando informações de marca registrada. |
Esses atributos podem aparecer na página de Propriedades do Windows do conjunto de módulos (assembly), ou eles podem ser substituídos usando o opção de compilador /win32res para especificar seus próprios recursos de arquivo Win32.
Atributos do manifesto do assembly
Você pode 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.
Atributos do manifesto do assembly |
Descrição |
|---|---|
Valor de sequência de caracteres que indica a configuração do conjunto, como comercial ou de depuração.O tempo de execução não usa esse valor. |
|
Valor de sequência de caracteres especificando um alias padrão a ser usado referenciando conjuntos de módulos (assemblies).Esse valor fornece uma nome amigável quando o próprio nome do conjunto de módulos (assembly) não é tão amigável (como um valor GUID).Esse valor também pode ser usado como um formulário curto do nome do conjunto completo. |
|
Valor de sequência de caracteres especificando uma breve descrição que resume a natureza e o objetivo do assembly. |
|
Valor de sequência de caracteres especificando um nome amigável para o assembly.Por exemplo, um conjunto de módulos (assembly) denominado comdlg pode ter o título de Microsoft Common Dialog Control. |
Atributos de nome de alta segurança
Você pode usar atributos de nome de alta segurança para definir um nome e alta segurança para um conjunto de módulos (assembly).A tabela a seguir descreve os atributos de noma de alta segurança.
Atributos de nome de alta segurança |
Descrição |
|---|---|
Valor booleano indicando que o atraso da assinatura está sendo usado. |
|
Valor de sequência de caracteres indicando o nome do arquivo que contenha ou a chave pública (se estiver usando atraso de assinatura) ou ambos as chaves públicas e privadas passadas como um parâmetro para o construtor deste atributo.Observe que o nome do arquivo é relativo ao endereço de saída do arquivo (o .exe ou .dll), não o endereço de destino do arquivo. |
|
Indica o contêiner de chave que contém o par de chaves passado como um parâmetro para o construtor deste atributo. |
O exemplo de código a seguir mostra os atributos para aplicar ao usar atraso de assinatura para criar um conjunto de nome de alta segurança com um arquivo chave pública chamado myKey.snk.
<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>
[assembly:AssemblyKeyFileAttribute(@"..\..\myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]