CA1830: Gunakan metode Tambahkan dan Sisipkan yang diketik dengan kuat di StringBuilder
| Properti | Nilai |
|---|---|
| ID Aturan | CA1830 |
| Judul | Lebih suka tambahkan yang ditik dengan kuat dan Sisipkan kelebihan beban metode pada StringBuilder |
| Golongan | Performa |
| Perbaikan bersifat disruptif atau non-disruptif | Non-disruptif |
| Diaktifkan secara default di .NET 8 | Sebagai saran |
Penyebab
Metode StringBuilder Append atau Insert dipanggil dengan argumen yang merupakan hasil panggilan ToString pada jenis di mana Append metode atau Insert memiliki kelebihan beban khusus.
Deskripsi aturan
Append dan Insert memberikan kelebihan muatan untuk beberapa jenis di luar String. Jika memungkinkan, pilih overload yang diketik dengan kuat daripada menggunakan ToString() dan overload berbasis string.
Cara memperbaiki pelanggaran
Hapus yang tidak perlu ToString() dari pemanggilan.
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();
}
}
Kapan harus menekan peringatan
Aman untuk menekan pelanggaran aturan ini jika Anda tidak khawatir tentang dampak performa dari alokasi string yang tidak perlu.
Menyembunyikan peringatan
Jika Anda hanya ingin menyembunyikan satu pelanggaran, tambahkan arahan praprosedur ke file sumber Anda untuk dinonaktifkan lalu aktifkan kembali aturannya.
#pragma warning disable CA1830
// The code that's violating the rule is on this line.
#pragma warning restore CA1830
Untuk menonaktifkan aturan untuk file, folder, atau proyek, atur tingkat keparahannya ke none dalam file konfigurasi.
[*.{cs,vb}]
dotnet_diagnostic.CA1830.severity = none
Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.
