Share via


CA1830: Voorkeur sterk getypte append- en insert-methode overloads on StringBuilder

Eigenschappen Weergegeven als
Regel-id CA1830
Titel Geef de voorkeur aan sterk getypte append- en insert-methode overloads in StringBuilder
Categorie Prestaties
Oplossing is brekend of niet-brekend Niet-brekend
Standaard ingeschakeld in .NET 8 Als suggestie

Oorzaak

Een StringBuilder Append of Insert methode werd aangeroepen met een argument dat het resultaat was van het aanroepen ToString van een type waarvoor de Append of Insert methode een toegewezen overbelasting heeft.

Beschrijving van regel

Append en Insert zorgen voor overbelastingen voor meerdere typen daarbuiten String. Indien mogelijk geeft u de voorkeur aan de sterk getypte overbelasting met behulp van ToString() en de op tekenreeks gebaseerde overbelasting.

Schendingen oplossen

Verwijder de onnodige ToString() aanroep.

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();
    }
}

Wanneer waarschuwingen onderdrukken

Het is veilig om een schending van deze regel te onderdrukken als u zich geen zorgen maakt over de gevolgen voor de prestaties van onnodige tekenreekstoewijzingen.

Een waarschuwing onderdrukken

Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.

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

Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst none ervan in op het configuratiebestand.

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

Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.

Zie ook