CA1824: Tandai rakitan dengan NeutralResourcesLanguageAttribute

Properti Nilai
ID Aturan CA1824
Judul Tandai perakitan menggunakan NeutralResourcesLanguageAttribute
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

Rakitan berisi sumber daya berbasis ResX tetapi tidak memiliki System.Resources.NeutralResourcesLanguageAttribute yang diterapkan padanya.

Deskripsi aturan

Atribut ini NeutralResourcesLanguageAttribute menginformasikan manajer sumber daya budaya default aplikasi. Jika sumber daya dari budaya bawaan disematkan dalam perakitan utama aplikasi, dan ResourceManager harus mengambil sumber daya yang termasuk dalam budaya yang sama dengan budaya bawaan, ResourceManager secara otomatis menggunakan sumber daya yang terletak di perakitan utama alih-alih mencari perakitan satelit. Ini melewati pemeriksaan rakitan yang biasa, meningkatkan performa pencarian untuk sumber daya pertama yang Anda muat, dan dapat mengurangi set kerja Anda.

Tips

Lihat Mengemas dan menyebarkan sumber daya untuk proses yang ResourceManager digunakan untuk memeriksa file sumber daya.

Memperbaiki pelanggaran

Untuk memperbaiki pelanggaran aturan ini, tambahkan atribut ke assembly, dan tentukan bahasa sumber daya budaya netral.

Untuk menentukan bahasa netral untuk sumber daya

  1. Di Penjelajah Solusi, klik kanan proyek Anda, lalu pilih Properti.

  2. Pilih tab Paket .

    Catatan

    Jika proyek Anda adalah proyek .NET Framework, pilih tab Aplikasi , lalu pilih Informasi Perakitan.

  3. Pilih bahasa dari daftar tarik-turun bahasa netral atau bahasa netral Assembly.

  4. Pilih OK.

Kapan harus menekan peringatan

Diperbolehkan mengabaikan peringatan dari aturan ini. Namun, performansi startup mungkin menurun. Untuk menyembunyikan peringatan ini, tambahkan dotnet_diagnostic.CA1824.severity = none ke file .globalconfig atau .editorconfig Anda.

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 CA1824
// The code that's violating the rule is on this line.
#pragma warning restore CA1824

Untuk menonaktifkan aturan untuk file, folder, atau proyek, atur tingkat keparahannya ke none dalam file konfigurasi.

[*.{cs,vb}]
dotnet_diagnostic.CA1824.severity = none

Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.

Lihat juga

  • Last updated on