CA1830: StringBuilder'da kesin türdeki Append ve Insert yöntemi aşırı yüklemelerini tercih edin

Özellik Değer
Kural Kimliği CA1830
Title StringBuilder'da kesin tür belirtilmiş Append ve Insert metodu aşırı yüklemelerini tercih et
Category Performans
Düzeltme bozucu veya bozucu olmayan niteliktedir Kesintisiz
.NET 10'da varsayılan olarak etkin Öneri olarak
.NET 11'de varsayılan olarak etkindir Öneri olarak
Geçerli diller C# ve Visual Basic

Neden

StringBuilder Append veya Insert yöntemi, ToString veya Append yöntemi için özel bir aşırı yüklemeye sahip bir türde Insert çağrısı ile elde edilen bir bağımsız değişkenle çağrıldı.

Kural açıklaması

Append ve Insert, String’nin ötesinde birden çok tür için aşırı yükleme sunar. Mümkün olduğunda, ToString() ve string tabanlı aşırı yükleme yerine kesin türdeki aşırı yüklemeleri tercih edin.

İhlalleri düzeltme

Çağrıdan gereksiz ToString() öğeyi silin.

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

Uyarıların ne zaman bastırılması gerekiyor?

Gereksiz string tahsislerinden kaynaklanan performans etkisi konusunda endişeniz yoksa, bu kuralın ihlalini bastırmak güvenlidir.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

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

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

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

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bkz.