CA1834: Tek karakterli dizeler için StringBuilder.Append(char) kullanın

Özellik	Değer
Kural Kimliği	CA1834
Başlık	Tek karakterli dizeler için StringBuilder.Append(char) kullanın
Kategori	Performans
Düzeltme bozucu ya da bozmayan olabilir	Kesintisiz
.NET 10'da varsayılan olarak etkin	Öneri olarak
Geçerli diller	C# ve Visual Basic

Neden

Bu kural, bir birim uzunluğu dizesi Append yöntemine geçirildiğinde tetiklenir.

Kural açıklaması

Birim uzunlukta bir dizeyle StringBuilder.Append çağırırken, performansı artırmak için birim uzunlukta bir const string yerine bir const char kullanmayı düşünün.

İhlalleri düzeltme

İhlal el ile düzeltilebilir veya bazı durumlarda Visual Studio'da kodu düzeltmek için Hızlı Eylemler kullanılabilir. Örnekler:

Örnek 1

Çağrılar StringBuilder.Append birim uzunluğunda bir dize değişmez değeriyle:

using System;
using System.Text;

namespace TestNamespace
{
    class TestClass
    {
        private void TestMethod()
        {
            StringBuilder sb = new StringBuilder();
            sb.Append("a");
        }
    }
}

İpucu

Visual Studio'da bu kural için bir kod düzeltmesi kullanılabilir. Bunu kullanmak için imleci ihlalin üzerine getirin ve Ctrl+. (nokta) tuşuna basın. Sunulan seçenekler listesinden, uygun olduğunda 'StringBuilder.Append(char)' kullanmayı düşünün ifadesini seçin.

Visual Studio tarafından uygulanan düzeltme:

using System;
using System.Text;

namespace TestNamespace
{
    class TestClass
    {
        private void TestMethod()
        {
            StringBuilder sb = new StringBuilder();
            sb.Append('a');
        }
    }
}

Bazı durumlarda, örneğin birim uzunluğu const string sınıf alanı kullanılırken Visual Studio tarafından bir kod düzeltmesi önerilmiyor (ancak çözümleyici yine de tetikleniyor). Bu örnekler için el ile düzeltme gerekir.

Örnek 2

StringBuilder.Append ile birim uzunluğunda bir sınıf alanına sahip çağrılar:

using System;
using System.Text;

namespace TestNamespace
{
    public class Program
    {
        public const string unitString = "a";

        static void Main(string[] args)
        {
            StringBuilder sb = new StringBuilder();
            sb.Append(unitString);
        }
    }
}

Dikkatli analizden sonra, burada unitString'ün herhangi bir derleme hatasına neden olmadan char olarak değiştirilebileceği görülmüştür.

using System;
using System.Text;

namespace TestNamespace
{
    public class Program
    {
        public const char unitString = 'a';

        static void Main(string[] args)
        {
            StringBuilder sb = new StringBuilder();
            sb.Append(unitString);
        }
    }
}

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

StringBuilder kullanırken performansı artırma 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 CA1834
// The code that's violating the rule is on this line.
#pragma warning restore CA1834

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.CA1834.severity = none

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

Ayrıca bkz.

• Performans kuralları