CA1016 : Marquer les assemblys avec AssemblyVersionAttribute

  • Article
Propriété Value
Identificateur de la règle CA1016
Titre Marquer les assemblys avec AssemblyVersionAttribute
Catégorie Conception
Le correctif est cassant ou non cassant Sans rupture
Activé par défaut dans .NET 8 À titre de suggestion

Cause

L’assembly n’a pas de numéro de version.

Description de la règle

L’identité d’un assembly est composée des informations suivantes :

  • Nom de l'assembly

  • Numéro de version

  • culture

  • Clé publique (pour les assemblys fortement nommés).

.NET utilise le numéro de version pour identifier un assembly de manière unique, et créer une liaison avec des types présents dans des assemblys à nom fort. Le numéro de version est utilisé conjointement avec la version et la stratégie d'éditeur. Par défaut, les applications s'exécutent uniquement avec la version d'assembly avec laquelle elles ont été construites.

Comment corriger les violations

Pour corriger une violation de cette règle, ajoutez un numéro de version à l’assembly à l’aide de l’attribut System.Reflection.AssemblyVersionAttribute.

Quand supprimer les avertissements

Ne supprimez pas un avertissement de cette règle pour les assemblys utilisés par des tiers ou dans un environnement de production.

Supprimer un avertissement

Si vous voulez supprimer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver et réactiver la règle.

#pragma warning disable CA1016
// The code that's violating the rule is on this line.
#pragma warning restore CA1016

Pour désactiver la règle sur un fichier, un dossier ou un projet, définissez sa gravité sur none dans le fichier de configuration.

[*.{cs,vb}]
dotnet_diagnostic.CA1016.severity = none

Pour plus d’informations, consultez Comment supprimer les avertissements de l’analyse de code.

Exemple

L’exemple suivant montre un assembly auquel l’attribut AssemblyVersionAttribute est appliqué.

using System;
using System.Reflection;

[assembly: AssemblyVersionAttribute("4.3.2.1")]
namespace DesignLibrary {}

<Assembly: AssemblyVersionAttribute("4.3.2.1")>
Namespace DesignLibrary
End Namespace

Voir aussi