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
Kategori	Performa
Perbaikan bersifat merusak atau tidak merusak	Tidak terputus
Diaktifkan secara default di .NET 10	Sebagai saran
Bahasa yang berlaku	C# dan Visual Basic

Penyebab

Metode StringBuilderAppend atau Insert dipanggil dengan argumen yang merupakan hasil panggilan ToString pada jenis di mana metode Append atau Insert memiliki overload khusus.

Deskripsi aturan

Append dan Insert memberikan kelebihan muatan untuk beberapa jenis di luar String. Jika memungkinkan, pilih overload yang bertipe kuat daripada menggunakan ToString() dan overload berbasis string.

Cara memperbaiki pelanggaran

Hapus ToString() yang tidak diperlukan dari invokasi.

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 kinerja