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 |
Hataya neden olan veya bozulmayan düzeltme | Hataya neden olmayan |
.NET 8'de varsayılan olarak etkin | Öneri olarak |
Neden
Bu kural, yönteme Append bir birim uzunluğu dizesi geçirildiğinde tetikler.
Kural açıklaması
Birim uzunluğu dizesiyle çağırırkenStringBuilder.Append
, performansı geliştirmek için birim uzunluğu const string
yerine bir kullanmayı const char
göz önünde bulundurun.
İ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
Birim uzunluğunda bir dize değişmez değeriyle çağrıları StringBuilder.Append
:
using System;
using System.Text;
namespace TestNamespace
{
class TestClass
{
private void TestMethod()
{
StringBuilder sb = new StringBuilder();
sb.Append("a");
}
}
}
Bahşiş
Visual Studio'da bu kural için bir kod düzeltmesi kullanılabilir. Bunu kullanmak için imleci ihlalin üzerine getirin ve Ctrl+ tuşuna (nokta) basın. Uygun olduğunda 'StringBuilder.Append(char)' kullanmayı düşünün'u seçin . Sunulan seçenekler listesinden.
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
Birim uzunluğunda bir const string
sınıf alanıyla çağrılarıStringBuilder.Append
:
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, unitString
burada derleme hatalarına neden olmadan olarak char
değiştirilebilir.
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?
kullanırken StringBuilder
performansı artırmakla ilgilenmiyorsanız, 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 none
olarak ayarlayın.
[*.{cs,vb}]
dotnet_diagnostic.CA1834.severity = none
Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin