CA1824: Tandai rakitan dengan NeutralResourcesLanguageAttribute

Artikel
12/16/2023

Properti	Nilai
ID Aturan	CA1824
Judul	Menandai rakitan dengan NeutralResourcesLanguageAttribute
Golongan	Performa
Perbaikan bersifat disruptif atau non-disruptif	Non-disruptif
Diaktifkan secara default di .NET 8	Sebagai saran

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 budaya default disematkan dalam perakitan utama aplikasi, dan ResourceManager harus mengambil sumber daya yang termasuk dalam budaya yang sama dengan budaya default, 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.

Tip

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

Di Penjelajah Solusi, klik kanan proyek Anda, lalu pilih Properti.
Pilih tab Paket .

Catatan

Jika proyek Anda adalah proyek .NET Framework, pilih tab Aplikasi , lalu pilih Informasi Perakitan.
Pilih bahasa dari bahasa netral atau daftar drop-down Bahasa netral Assembly.
Pilih OK.

Kapan harus menekan peringatan

Diperbolehkan untuk menekan peringatan dari aturan ini. Namun, performa startup mungkin menurup. 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.

Bagikan melalui