CA1830 : Préférer les surcharges de méthode Append et Insert fortement typées sur StringBuilder
| Propriété | Value |
|---|---|
| Identificateur de la règle | CA1830 |
| Titre | Préférer les surcharges de méthode Append et Insert fortement typées sur StringBuilder |
| Catégorie | Performances |
| Le correctif est cassant ou non cassant | Sans rupture |
| Activée par défaut dans .NET 9 | À titre de suggestion |
Cause
Une StringBuilder Append ou Insert méthode a été appelée avec un argument qui a été le résultat de l’appel ToString sur un type pour lequel la ou Insert la Append méthode a une surcharge dédiée.
Description de la règle
Append et Insert fournissent des surcharges pour plusieurs types au-delà de String. Si possible, préférez les surcharges fortement typées plutôt que l’utilisation de ToString() et la surcharge basée sur des chaînes.
Comment corriger les violations
Supprimez le ToString() inutile de l’appel.
using System.Text;
class C
{
int _value;
// Violation
public void Log(StringBuilder destination)
{
destination.Append("Value: ").Append(_value.ToString()).AppendLine();
}
// Fixed
public void Log(StringBuilder destination)
{
destination.Append("Value: ").Append(_value).AppendLine();
}
}
Quand supprimer les avertissements
Vous pouvez sanas risque supprimer une violation de cette règle si vous ne vous souciez pas de l’impact sur les performances dû aux allocations de chaînes inutiles.
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 CA1830
// The code that's violating the rule is on this line.
#pragma warning restore CA1830
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.CA1830.severity = none
Pour plus d’informations, consultez Comment supprimer les avertissements de l’analyse de code.
