Utiliser des attributs AssemblyVersion et AssemblyFileVersion

Cet article explique comment utiliser et AssemblyFileVersion attribuer AssemblyVersion des attributs dans le fichier AssemblyInfo.cs.

Version du produit d’origine : .NET Framework
Numéro de base de connaissances d’origine : 556041

Résumé

AssemblyInfo.cs fournit deux attributs pour définir deux types de versions différents. Ce conseil montre comment utiliser ces deux attributs.

Microsoft .NET Framework offre la possibilité de définir deux types de numéros de version différents sur chaque assembly.

AssemblyVersion

Il s’agit du numéro de version utilisé par l’infrastructure pendant la génération et au moment de l’exécution pour localiser, lier et charger les assemblys. Lorsque vous ajoutez une référence à un assembly dans votre projet, il s’agit de ce numéro de version incorporé. Au moment de l’exécution, Common Language Runtime (CLR) recherche l’assembly avec ce numéro de version à charger. Mais n’oubliez pas que cette version est utilisée avec le nom, le jeton de clé publique et les informations de culture uniquement si les assemblys sont signés avec un nom fort. Si les assemblys ne sont pas signés avec nom fort, seuls les noms de fichiers sont utilisés pour le chargement.

AssemblyFileVersion

Il s’agit du numéro de version donné au fichier comme dans le système de fichiers. Il s’affiche par l’Explorateur Windows et n’est jamais utilisé par le .NET Framework ou le runtime pour référencer.

Attributs dans AssemblyInfo.cs

// Version information for an assembly consists of the following four values:
// Major Version
// Minor Version
// Build Number
// Revision
[assembly: AssemblyVersion("1.0.0.0")]  
[assembly: AssemblyFileVersion("1.0.0.0")]

Fournir un (*) à la place d’un nombre absolu rend le compilateur augmenter le nombre par un à chaque génération.

Supposons que vous créez un assembly de framework pour votre projet qui est utilisé par beaucoup de développeurs lors de la génération des assemblys d’application. Si vous publiez fréquemment la nouvelle version de l’assembly, par exemple une fois par jour et si les assemblys sont forts nommés, les développeurs devront modifier la référence chaque fois que vous publiez un nouvel assembly. Il peut être fastidieux et peut entraîner des références incorrectes également. Une meilleure option dans ces scénarios de groupe fermé et volatile serait de corriger et AssemblyVersion de modifier uniquement le AssemblyFileVersion. Utilisez le numéro de version du fichier d’assembly pour communiquer la dernière version de l’assembly. Dans ce cas, les développeurs n’auront pas à modifier les références et ils peuvent remplacer l’assembly dans le chemin d’accès de référence. Dans les builds de version centrale ou finale, il est plus judicieux de modifier la version de l’assembly AssemblyVersion et de conserver la même chose que la AssemblyFileVersion version de l’assembly.