Numéros de version de l'assembly principal et des assemblys satellites localisésVersion Numbers for Main and Localized Satellite Assemblies

La classe SatelliteContractVersionAttribute fournit la prise en charge de la gestion de version pour un assembly principal qui utilise des ressources localisées via le Gestionnaire des ressources.The SatelliteContractVersionAttribute class provides versioning support for a main assembly that uses localized resources by means of the resource manager. L’application d’un SatelliteContractVersionAttribute à l’assembly principal d’une application permet de mettre à jour et de redéployer cet assembly, sans mettre à jour ses assemblys satellites.Applying the SatelliteContractVersionAttribute to an application's main assembly allows you to update and re-deploy the assembly without updating its satellite assemblies. Par exemple, vous pouvez utiliser la classe SatelliteContractVersionAttribute avec un Service Pack qui n’introduit pas de nouvelles ressources sans régénérer et redéployer vos assemblys satellites.For example, you can use the SatelliteContractVersionAttribute class with a service pack that doesn't introduce new resources without rebuilding and redeploying your satellite assemblies. Pour que vos ressources localisées soient disponibles, la version de contrat satellite de votre assembly principal doit correspondre à la classe AssemblyVersionAttribute de vos assemblys satellites.For your localized resources to be available, the satellite contract version of your main assembly must match the AssemblyVersionAttribute class of your satellite assemblies. Vous devez spécifier un numéro de version exact dans la classe SatelliteContractVersionAttribute ; les caractères génériques tels que « * » ne sont pas autorisés.You must specify an exact version number in the SatelliteContractVersionAttribute; wildcard characters such as "*" are not allowed. Pour plus d’informations, consultez Récupération de ressources.For more information, see Retrieving Resources.

Mise à jour des assemblysUpdating Assemblies

La classe SatelliteContractVersionAttribute permet de mettre à jour un assembly principal sans avoir à mettre à jour les assemblys satellites, et vice versa.The SatelliteContractVersionAttribute class allows you to update a main assembly without having to update your satellite assembly, or vice versa. Lorsque l’assembly principal est mis à jour, son numéro de version est modifié.When the main assembly is updated, its assembly version number is changed. Si vous souhaitez continuer à utiliser les assemblys satellites existants, modifiez le numéro de version de l’assembly principal, mais conservez le numéro de version de contrat satellite.If you want to continue using the existing satellite assemblies, change the main assembly's version number but leave the satellite contract version number the same. Par exemple, dans votre première version, la version de l’assembly principal peut être 1.0.0.0.For example, in your first release your main assembly version may be 1.0.0.0. Dans ce cas, la version de contrat satellite et la version d’assembly de l’assembly satellite seront également 1.0.0.0.The satellite contract version and the assembly version of the satellite assembly will also be 1.0.0.0. Si vous devez mettre à jour votre assembly principal pour un Service Pack, vous pouvez remplacer la version d’assembly par 1.0.0.1, tout en conservant la valeur 1.0.0.0 pour la version de contrat satellite et la version d’assembly du satellite.If you need to update your main assembly for a service pack, you can change the assembly version to 1.0.0.1, while keeping the satellite contract version and the satellite's assembly version as 1.0.0.0.

Si vous devez mettre à jour un assembly satellite, mais pas votre assembly principal, modifiez le AssemblyVersionAttribute de l’assembly satellite.If you need to update a satellite assembly but not your main assembly, you change the AssemblyVersionAttribute of the satellite assembly. En même temps que votre assembly satellite, vous devez livrer un assembly de stratégie indiquant que votre nouvel assembly satellite est compatible avec votre ancien assembly satellite.Along with your satellite assembly, you will have to ship a policy assembly that states that your new satellite assembly is compatible with your old satellite assembly. Pour plus d’informations, consultez Méthode de localisation des assemblys par le runtime.For more information on policies, see How the Runtime Locates Assemblies.

Le code suivant montre la définition d’une version de contrat satellite.The following code shows how to set the satellite contract version. Le code peut être placé dans un script de build, ou dans le fichier AssemblyInfo.vb ou AssemblyInfo.cs.The code can be placed in either a build script or in the AssemblyInfo.vb or AssemblyInfo.cs file.

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

Voir aussiSee Also

Méthode de localisation des assemblys par le runtime How the Runtime Locates Assemblies
Définition des attributs d’assembly Setting Assembly Attributes
Sécurité et assemblys satellites localisés Security and Localized Satellite Assemblies
Localisation d’applications Localizing Applications
Globalisation et localisation d’applicationsGlobalizing and Localizing Applications