CA1511 : Utiliser l’assistance de levée ArgumentException
Propriété | Value |
---|---|
Identificateur de la règle | CA1511 |
Titre | Utiliser l’assistance de levée ArgumentException |
Catégorie | Maintenabilité |
Le correctif est cassant ou non cassant | Non cassant |
Activée par défaut dans .NET 9 | À titre de suggestion |
Cause
Le code vérifie si un argument est null
ou une chaîne vide, puis lève conditionnellement un ArgumentException.
Description de la règle
Les vérifications d’argument ont un impact important sur la taille du code et dominent souvent le code pour les petites fonctions et les setters de propriétés. Ces vérifications empêchent les incorporations et provoquent une pollution substantielle du cache d’instructions. Les méthodes d’assistance de levée comme if
sont plus simples et plus efficaces que les blocs ArgumentException.ThrowIfNullOrEmpty(String, String) construisant une nouvelle instance d’exception.
Exemple
L’extrait de code suivant montre une violation de CA1511 :
void M(string arg)
{
if (string.IsNullOrEmpty(arg))
throw new ArgumentException("", "arg");
}
L’extrait de code suivant montre le correctif :
void M(string arg)
{
ArgumentException.ThrowIfNullOrEmpty(arg);
}
Comment corriger les violations
Remplacez le bloc if
qui lève l’exception par un appel à ArgumentException.ThrowIfNullOrEmpty(String, String). Ou, dans Visual Studio, utilisez le menu Ampoule pour corriger automatiquement votre code.
Quand supprimer les avertissements
Il est sûr de supprimer une violation de cette règle si vous n’êtes pas préoccupé par la maintenance de votre code. Il est également très facile de supprimer les violations qui sont identifiées comme étant de faux positifs.
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 CA1511
// The code that's violating the rule is on this line.
#pragma warning restore CA1511
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.CA1511.severity = none
Pour plus d’informations, consultez Comment supprimer les avertissements de l’analyse de code.