Partager via

Gestion des versions d’un assembly

Toutes les versions des assemblys qui utilisent le Common Language Runtime sont effectuées au niveau de l’assembly. La version spécifique d’un assembly et les versions des assemblys dépendants sont enregistrées dans le manifeste de l’assembly. La stratégie de version par défaut pour le runtime est que les applications s’exécutent uniquement avec les versions avec lesquelles elles ont été générées et testées, sauf si elles sont remplacées par une stratégie de version explicite dans les fichiers de configuration (le fichier de configuration de l’application, le fichier de stratégie d’éditeur et le fichier de configuration administrateur de l’ordinateur).

Le runtime effectue plusieurs étapes pour résoudre une demande de liaison d’assembly :

  1. Vérifie la référence d’assembly d’origine pour déterminer la version de l’assembly à lier.

  2. Recherche tous les fichiers de configuration applicables pour appliquer la stratégie de version.

  3. Détermine l’assembly correct à partir de la référence d’assembly d’origine et toute redirection spécifiée dans les fichiers de configuration, et détermine la version qui doit être liée à l’assembly appelant.

  4. Vérifie le global assembly cache, codebases spécifiés dans les fichiers de configuration, puis vérifie le répertoire et les sous-répertoires de l’application à l’aide des règles de détection expliquées dans comment le runtime localise les assemblys.

L’illustration suivante montre les étapes suivantes :

Diagramme montrant les étapes de résolution de demande de liaison d’assembly.

Pour plus d’informations sur la configuration des applications, consultez Configurer des applications. Pour plus d’informations sur la stratégie de liaison, consultez Comment le runtime localise les assemblys.

Détails de version

Chaque assembly a deux façons distinctes d’exprimer des informations de version :

  • Le numéro de version de l’assembly, qui, avec le nom de l’assembly et les informations de culture, fait partie de l’identité de l’assembly. Ce nombre est utilisé par le runtime pour appliquer la stratégie de version et joue un rôle clé dans le processus de résolution de type au moment de l’exécution.

  • Version d’information, qui est une chaîne qui représente des informations de version supplémentaires incluses uniquement à des fins d’information.

Numéro de version de l’assembly

Chaque assembly a un numéro de version dans le cadre de son identité. Par conséquent, deux assemblys qui diffèrent par numéro de version sont considérés par le runtime comme des assemblys complètement différents. Ce numéro de version est physiquement représenté sous forme de chaîne en quatre parties au format suivant :

< version> principale.<version> mineure.<numéro> de build.<révision>

Par exemple, la version 1.5.1254.0 indique 1 comme version principale, 5 comme version mineure, 1254 comme numéro de build et 0 comme numéro de révision.

Le numéro de version est stocké dans le manifeste d’assembly ainsi que d’autres informations d’identité, notamment le nom de l’assembly et la clé publique, ainsi que des informations sur les relations et les identités d’autres assemblys connectés à l’application.

Lorsqu’un assembly est généré, l’outil de développement enregistre les informations de dépendance pour chaque assembly référencé dans le manifeste d’assembly. Le runtime utilise ces numéros de version, conjointement avec les informations de configuration définies par un administrateur, une application ou un éditeur, pour charger la version appropriée d’un assembly référencé.

Le runtime fait la distinction entre les assemblys standard et avec nom fort à des fins de contrôle de version. La vérification de version se produit uniquement avec des assemblys nommés fort.

Pour plus d’informations sur la spécification de stratégies de liaison de version, consultez Configurer des applications. Pour plus d’informations sur la façon dont le runtime utilise des informations de version pour rechercher un assembly particulier, consultez Comment le runtime localise les assemblys.

Version d’informations sur l’assemblage

La version informationnelle est une chaîne qui attache des informations de version supplémentaires à un assembly à des fins d’information uniquement ; ces informations ne sont pas utilisées au moment de l’exécution. La version d’information textuelle correspond à la documentation marketing, à l’empaquetage ou au nom du produit du produit et n’est pas utilisée par le runtime. Par exemple, une version informationnelle peut être « Common Language Runtime version 1.0 » ou « NET Control SP 2 ». Sous l’onglet Version de la boîte de dialogue Propriétés du fichier dans Microsoft Windows, ces informations s’affichent dans l’élément « Version du produit ».

Remarque

Bien que vous puissiez spécifier n’importe quel texte, un message d’avertissement s’affiche sur la compilation si la chaîne n’est pas au format utilisé par le numéro de version de l’assembly, ou s’il se trouve dans ce format, mais contient des caractères génériques. Cet avertissement est inoffensif.

La version d’information est représentée à l’aide de l’attribut System.Reflection.AssemblyInformationalVersionAttributepersonnalisé. Pour plus d’informations sur l’attribut de version informationnelle, consultez Définir des attributs d’assembly.

Voir aussi