Bagikan melalui

CA2255: Atribut ModuleInitializer tidak boleh digunakan dalam pustaka

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

Baca juga