Controle de versão do assembly

Todo o controle de versão de assemblies que usam o common language runtime é feito no nível de assembly. A versão específica de um assembly e as versões dos assemblies dos quais depende são registadas no manifesto do assembly. A política de versão padrão para o tempo de execução é que os aplicativos são executados somente com as versões com as quais foram criados e testados, a menos que sejam substituídos pela política de versão explícita nos arquivos de configuração (o arquivo de configuração do aplicativo, o arquivo de diretiva do editor e o arquivo de configuração do administrador do computador).

O tempo de execução executa várias etapas para resolver uma solicitação de vinculação de assembly:

1. Verifica a referência do assembly original para determinar a versão do assembly a ser vinculada.

2. Verifica se há todos os arquivos de configuração aplicáveis para aplicar a política de versão.

3. Determina o assembly correto a partir da referência de assembly original e de qualquer redirecionamento especificado nos ficheiros de configuração, e determina a versão que deve ser vinculada ao assembly chamador.

4. Verifica o cache de assembly global, as bases de código especificadas nos arquivos de configuração e, em seguida, verifica o diretório e os subdiretórios do aplicativo usando as regras de sondagem explicadas em Como o tempo de execução localiza assemblies.

A ilustração a seguir mostra essas etapas:

Para obter mais informações sobre como configurar aplicativos, consulte Configurar aplicativos. Para obter mais informações sobre a política de vinculação, consulte Como o tempo de execução localiza conjuntos.

Informações sobre a versão

Cada montagem tem duas maneiras distintas de expressar informações de versão:

• O número da versão do conjunto, que, juntamente com o nome do conjunto e as informações culturais, faz parte da identidade do conjunto. Este número é usado pelo runtime para aplicar a política de versão e desempenha um papel fundamental no processo de resolução de tipos em tempo de execução.

• Uma versão informativa, que é uma cadeia de caracteres que representa informações de versão adicionais incluídas apenas para fins informativos.

Número da versão do assembly

Cada montagem tem um número de versão como parte da sua identidade. Como tal, dois assemblies que diferem pelo número de versão são considerados pelo tempo de execução como assemblies completamente diferentes. Este número de versão é fisicamente representado como uma cadeia de caracteres de quatro partes com o seguinte formato:

< versão> principal.<versão> secundária.<número de> compilação.<revisão>

Por exemplo, a versão 1.5.1254.0 indica 1 como a versão principal, 5 como a versão secundária, 1254 como o número de compilação e 0 como o número de revisão.

O número da versão é armazenado no manifesto do assembly junto com outras informações de identidade, incluindo o nome do assembly e a chave pública, bem como informações sobre relacionamentos e identidades de outros assemblies conectados ao aplicativo.

Quando um assembly é criado, a ferramenta de desenvolvimento regista a informação sobre dependências para cada assembly que esteja referenciado no manifesto do assembly. O tempo de execução usa esses números de versão, em conjunto com informações de configuração definidas por um administrador, um aplicativo ou um editor, para carregar a versão adequada de um assembly referenciado.

O tempo de execução distingue entre assemblies regulares e de nome forte para fins de controle de versão. A verificação de versão só ocorre com assemblies de nome forte.

Para obter informações sobre como especificar políticas de vinculação de versão, consulte Configurar aplicativos. Para obter informações sobre como o tempo de execução usa informações de versão para localizar um assembly específico, consulte Como o tempo de execução localiza assemblies.

Versão informativa da montagem

A versão informativa é uma cadeia que anexa informação adicional de versão a um conjunto apenas para fins informativos; Esta informação não é utilizada em tempo de execução. A versão informativa baseada em texto corresponde à literatura de marketing, embalagem ou nome do produto e não é usada pelo tempo de execução. Por exemplo, uma versão informativa pode ser "Common Language Runtime versão 1.0" ou "NET Control SP 2". Na guia versão da caixa de diálogo de propriedades do arquivo no Microsoft Windows, essas informações aparecem no item "Versão do produto".

A versão informativa é representada usando o atributo personalizado System.Reflection.AssemblyInformationalVersionAttribute. Para obter mais informações sobre o atributo de versão informativa , consulte Definir atributos de assembly.

Ver também

• Como o tempo de execução localiza assembleias
• Configurar aplicativos
• Definir atributos de assemblagem
• assemblies no .NET