CA1830: StringBuilder'da kesin türdeki Ekleme ve Ekleme yöntemi aşırı yüklemelerini tercih edin
| Özellik | Değer |
|---|---|
| Kural Kimliği | CA1830 |
| Başlık | StringBuilder'da kesin tür belirtilmiş Append ve Insert metodu aşırı yüklemelerini tercih et |
| Kategori | Performans |
| Hataya neden olan veya bozulmayan düzeltme | Hataya neden olmayan |
| .NET 9'da varsayılan olarak etkin | Öneri olarak |
Neden
StringBuilder Append Veya yöntemi, veya Insert yönteminin ayrılmış aşırı yüklemesine sahip olduğu bir tür üzerinde çağrılmasının ToString Append Insert sonucu olan bir bağımsız değişkenle çağrıldı.
Kural açıklaması
Append ve Insert dışındaki Stringbirden çok tür için aşırı yüklemeler sağlar. Mümkün olduğunda, ToString() ve dize 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 dize ayırmalarından 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 none olarak ayarlayın.
[*.{cs,vb}]
dotnet_diagnostic.CA1830.severity = none
Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.
