System.Resources.SatelliteContractVersionAttribute classe

Este artigo fornece observações complementares à documentação de referência para essa API.

Em aplicativos de desktop, o SatelliteContractVersionAttribute atributo estabelece um contrato entre um conjunto principal e todos os seus satélites. Você aplica esse atributo ao assembly principal e passa a ele o número da versão dos assemblies satélites que funcionarão com essa versão do assembly principal. Quando o gerenciador de recursos (ResourceManager objeto) procura recursos, ele carrega explicitamente a versão satélite especificada por esse atributo no assembly principal.

Ao atualizar o assembly principal, você incrementa seu número de versão do assembly. No entanto, talvez você não queira enviar novas cópias de seus assemblies satélites se os existentes forem compatíveis com seu aplicativo. Nesse caso, incremente o número de versão do assembly principal, mas deixe o número de versão do contrato satélite o mesmo. O gerenciador de recursos usará seus assemblies satélites existentes.

Se você quiser revisar um assembly satélite, mas não o assembly principal, incremente o número da versão em seu satélite. Nesse caso, envie um assembly de política de editor junto com o assembly satélite informando que o novo assembly satélite tem compatibilidade com versões anteriores do assembly satélite antigo. O gerenciador de recursos ainda usará o número de contrato antigo gravado em seu assembly principal com base no atributo, no SatelliteContractVersionAttribute entanto, o carregador será vinculado à versão do assembly satélite especificada pelo assembly de política.

Um fornecedor de um componente compartilhado usa um assembly de política de editor para fazer uma declaração de compatibilidade sobre uma versão específica de um assembly lançado. Um assembly de política de editor é um assembly fortemente nomeado que tem um nome no formato policy.<major>.<minor>.<ComponentAssemblyName>e está registrado no GAC (Global Assembly Cache). A política de editor é gerada a partir de um arquivo de configuração XML (consulte o <elemento bindingRedirect>) usando a ferramenta Al.exe (Assembly Linker). O Assembly Linker é usado com a opção de vincular o arquivo de configuração XML a /link um assembly de manifesto, que é armazenado no cache global do assembly. Os assemblies de política do editor podem ser usados quando um fornecedor envia uma versão de manutenção (service pack) que contém correções de bugs.

Aplicativos da Windows Store 8.x

Esse atributo é ignorado em aplicativos da Windows Store 8.x, porque os arquivos PRI (índice de recursos de pacote) não têm semântica de controle de versão. Além disso, o modelo de empacotamento da Windows 8.x Store requer que todos os recursos sejam enviados no mesmo pacote, sem possibilidade de reimplantar assemblies satélite ou arquivos PRI.