CA2255: ModuleInitializer Öznitelik kitaplıklarda kullanılmamalıdır

  • Makale
Özellik Değer
Kural Kimliği CA2255
Başlık ModuleInitializer Öznitelik kitaplıklarda kullanılmamalıdır
Kategori Kullanım
Hataya neden olan veya bozulmayan düzeltme Hataya neden olmayan
.NET 8'de varsayılan olarak etkin Uyarı olarak

Neden

ModuleInitializerAttribute Sınıf Kitaplığı içindeki bir yönteme uygulama.

Kural açıklaması

Modül başlatıcıları, uygulama kodu yürütülmeye başlamadan önce uygulamanın bileşenlerinin başlatılmasını sağlamak için uygulama kodu tarafından kullanılması amaçlanmıştır. Kitaplık kodu ile ModuleInitializerAttributebir yöntem bildirirse, uygulamanın başlatılmasını engelleyebilir ve ayrıca uygulamanın kırpma yeteneklerinde sınırlamalara yol açabilir. Bu nedenle kitaplık kodu özniteliğini ModuleInitializerAttribute kullanmamalıdır.

İhlalleri düzeltme

ile ModuleInitializerAttributeişaretlenmiş yöntemleri kullanmak yerine, kitaplık içinde herhangi bir bileşeni başlatmak için kullanılabilecek yöntemleri kullanıma sunmalı ve uygulamanın uygulama başlatma sırasında yöntemini çağırmasına izin vermelidir.

Uyarıların ne zaman bastırılması gerekiyor?

Bir çözüm kod faktörü oluşturma amacıyla Sınıf Kitaplığı kullanıyorsa ve yöntem paylaşılan veya dağıtılmış bir kitaplığın veya paketin ModuleInitializerAttribute parçası değilse, bu kuraldan gelen uyarıların gizlenmesi güvenlidir.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA2255
// The code that's violating the rule is on this line.
#pragma warning restore CA2255

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

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

Bu kural kategorisinin tamamını devre dışı bırakmak için, kategorinin önem derecesini noneyapılandırma dosyasında olarak ayarlayın.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Usage.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bkz.