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 10	Sebagai saran

Penyebab

Metode StringBuilderAppend 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.

Lihat juga

• Aturan performa