Compartilhar via


Números de versão para assemblies principal e satélite localizados

O SatelliteContractVersionAttribute classe fornece suporte de versionamento para um assembly principal que usa os recursos localizados por meio do Gerenciador de recursos.Aplicando o SatelliteContractVersionAttribute a um aplicativo assembly principal permite que você atualize e reimplantar o assembly sem atualizar seus assemblies satélites.Por exemplo, você pode usar o SatelliteContractVersionAttribute classe com um service pack que não introduza novos recursos sem reconstrução e reimplantação seus assemblies satélites.Para seus recursos localizados esteja disponível, a versão do contrato satélite do seu assembly principal deve coincidir com o AssemblyVersionAttribute classe dos seus assemblies satélites.Você deve especificar um número de versão exato na SatelliteContractVersionAttribute; caracteres curinga como "*" não são permitidos.Para obter mais informações, consulte Recuperando recursos em aplicativos de área de trabalho.

Atualizando Assemblies

O SatelliteContractVersionAttribute classe permite que você atualizar um assembly principal sem ter que atualizar seu assembly satélite, ou vice-versa.Quando o assembly principal for atualizado, seu número de versão assembly é alterado.Se você deseja continuar usando os assemblies satélite existentes, altere o número de versão do assembly principal mas deixe o número da versão contrato do satélite o mesmo.Por exemplo, na sua primeira versão sua versão assembly principal pode estar 1.0.0.0.A versão contrato do satélite e a versão assembly do assembly satélite também serão 1.0.0.0.Se você necessita atualizar seu assembly principal para um Service Pack, você pode mudar a versão assembly para 1.0.0.1, mantendo a versão contrato do satélite e a versão do assembly satélite como 1.0.0.0.

Se você precisar atualizar um assembly satélite mas não seu assembly principal, se você altera o AssemblyVersionAttribute do assembly satélite.Juntamente com seu assembly satélite, você terá que enviar uma política assembly que afirma que seu novo assembly satélite é compatível com seu assembly satélite antigo.Para obter mais informações sobre políticas, consulte Como o Runtime Localiza Assemblies.

O código a seguir mostra como definir a versão contrato satélite.O código pode ser colocado em um script de compilação ou no arquivo AssemblyInfo.vb ou AssemblyInfo.cs.

<Assembly: SatelliteContractVersionAttribute("4.3.2.1")>
[assembly: SatelliteContractVersionAttribute("4.3.2.1")]

Consulte também

Conceitos

Como o tempo de execução localiza assemblies

Definindo atributos de assembly

Assemblies satélite de segurança e localizados

Outros recursos

Localizando aplicativos

Aplicativos de globalização e localização