CA2255: Atribut ModuleInitializer
tidak boleh digunakan dalam pustaka
Properti | Nilai |
---|---|
ID Aturan | CA2255 |
Judul | Atribut ModuleInitializer tidak boleh digunakan dalam pustaka |
Golongan | Penggunaan |
Perbaikan bersifat disruptif atau non-disruptif | Non-disruptif |
Diaktifkan secara default di .NET 8 | Sebagai peringatan |
Penyebab
Menerapkan ModuleInitializerAttribute ke metode dalam Pustaka Kelas.
Deskripsi aturan
Penginisialisasi modul dimaksudkan untuk digunakan oleh kode aplikasi untuk memastikan komponen aplikasi diinisialisasi sebelum kode aplikasi memulai eksekusi. Jika kode pustaka mendeklarasikan metode dengan ModuleInitializerAttribute, itu dapat mengganggu inisialisasi aplikasi dan juga menyebabkan pembatasan dalam kemampuan pemangkasan aplikasi tersebut. Oleh karena itu, kode pustaka tidak boleh menggunakan atribut ModuleInitializerAttribute.
Cara memperbaiki pelanggaran
Alih-alih menggunakan metode yang ditandai dengan ModuleInitializerAttribute, pustaka harus mengekspos metode yang dapat digunakan untuk menginisialisasi komponen apa pun dalam pustaka dan mengizinkan aplikasi untuk memanggil metode selama inisialisasi aplikasi.
Kapan harus menekan peringatan
Aman untuk menyembunyikan peringatan dari aturan ini jika solusi menggunakan Pustaka Kelas untuk tujuan pemfaktoran kode, dan metode ModuleInitializerAttribute bukan bagian dari pustaka atau paket bersama atau terdistribusi.
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 CA2255
// The code that's violating the rule is on this line.
#pragma warning restore CA2255
Untuk menonaktifkan aturan untuk file, folder, atau proyek, atur tingkat keparahannya ke none
dalam file konfigurasi.
[*.{cs,vb}]
dotnet_diagnostic.CA2255.severity = none
Untuk menonaktifkan seluruh kategori aturan ini, atur tingkat keparahan untuk kategori ke none
dalam file konfigurasi.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Usage.severity = none
Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.