CA1716 : Les identificateurs ne doivent pas correspondre à des mots clés
| Propriété | Value |
|---|---|
| Identificateur de la règle | CA1716 |
| Titre | Les identificateurs ne doivent pas correspondre à des mots clés |
| Catégorie | Dénomination |
| Le correctif est cassant ou non cassant | Rupture |
| Activée par défaut dans .NET 9 | Non |
Cause
Le nom d’un espace de noms, d’un type ou d’un membre virtuel ou d’interface correspond à un mot clé réservé dans un langage de programmation.
Par défaut, cette règle n’examine que les espaces de noms, les types et les membres visibles en externe, mais vous pouvez configurer la visibilité et les types de symboles.
Description de la règle
Les identificateurs des espaces de noms, des types et des membres virtuels et d’interface ne doivent pas correspondre aux mots clés définis par les langages qui ciblent le Common Language Runtime. Selon le langage utilisé et le mot clé, les erreurs et ambiguïtés du compilateur peuvent rendre l’utilisation de la bibliothèque difficile.
Cette règle vérifie les mots clés dans les langages suivants :
- Visual Basic
- C#
- C++/CLI
La comparaison sans respect de la casse est utilisée pour les mots clés Visual Basic, et la comparaison respectant la casse dans les autres langages.
Comment corriger les violations
Sélectionnez un nom qui n’apparaît pas dans la liste des mots clés.
Quand supprimer les avertissements
Vous pouvez supprimer un avertissement de cette règle si vous avez la certitude que l’identificateur ne confond pas les utilisateurs de l’API et que la bibliothèque est utilisable dans tous les langages disponibles dans .NET.
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 CA1716
// The code that's violating the rule is on this line.
#pragma warning restore CA1716
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.CA1716.severity = none
Pour plus d’informations, consultez Comment supprimer les avertissements de l’analyse de code.
Configurer le code à analyser
Utilisez l’option suivante pour configurer les parties de votre codebase sur lesquelles exécuter cette règle.
Vous pouvez configurer ces options pour cette règle uniquement, pour toutes les règles auxquelles elles s’appliquent ou pour toutes les règles de cette catégorie (Nommage) auxquelles elles s’appliquent. Pour plus d’informations, consultez Options de configuration des règles de qualité du code.
Inclure des surfaces d’API spécifiques
Vous pouvez configurer les parties de votre codebase sur lesquelles exécuter cette règle, en fonction de leur accessibilité. Par exemple, pour spécifier que la règle doit s’exécuter uniquement sur la surface d’API non publique, ajoutez la paire clé-valeur suivante à un fichier .editorconfig dans votre projet :
dotnet_code_quality.CAXXXX.api_surface = private, internal
Types de symboles analysés
Vous pouvez configurer les types de symboles qui seront analysés par cette règle. Les valeurs autorisées sont les suivantes :
NamespaceNamedTypeMethodPropertyEventParameter
Séparez les valeurs par des virgules (,). La valeur par défaut inclut tous les types de symboles de la liste précédente.
dotnet_code_quality.CA1716.analyzed_symbol_kinds = Namespace, NamedType, Method, Property, Event
