CA1725 : Les noms des paramètres doivent correspondre à la déclaration de base
| Propriété | Value |
|---|---|
| Identificateur de la règle | CA1725 |
| Titre | Les noms des paramètres doivent correspondre à la déclaration de base |
| Catégorie | Dénomination |
| Le correctif est cassant ou non cassant | Rupture |
| Activé par défaut dans .NET 8 | Non |
Cause
Le nom d’un paramètre dans une substitution de méthode ne correspond pas au nom du paramètre dans la déclaration de base de la méthode ou au nom du paramètre dans la déclaration d’interface de la méthode.
Par défaut, cette règle examine uniquement les méthodes visibles en externe, mais elle est configurable.
Description de la règle
La désignation cohérente des paramètres dans une hiérarchie de substitution augmente la facilité d'utilisation des substitutions de méthode. Un nom de paramètre dans une méthode dérivée qui diffère du nom dans la déclaration de base peut créer une confusion pour déterminer si la méthode est une substitution de la méthode de base ou une nouvelle surcharge de la méthode.
Comment corriger les violations
Pour corriger une violation de cette règle, renommez le paramètre pour qu’il corresponde à la déclaration de base. Le correctif est un changement cassant pour les méthodes visibles COM.
Quand supprimer les avertissements
Ne supprimez pas d’avertissement de cette règle, à l’exception des méthodes visibles COM dans les bibliothèques qui ont précédemment été expédiées.
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 CA1725
// The code that's violating the rule is on this line.
#pragma warning restore CA1725
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.CA1725.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 cette option pour cette règle uniquement, pour toutes les règles auxquelles elle s’applique ou pour toutes les règles de cette catégorie (Nommage) auxquelles elle s’applique. 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
