Bagikan melalui

CA1830: Gunakan metode Tambahkan dan Sisipkan yang diketik dengan kuat di StringBuilder

  • Artikel
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 9 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