Partilhar via

CA2255: O ModuleInitializer atributo não deve ser usado em bibliotecas

  • Artigo
Property valor
ID da regra CA2255
Título O ModuleInitializer atributo não deve ser usado em bibliotecas
Categoria Utilização
A correção está quebrando ou não quebrando Sem quebra
Habilitado por padrão no .NET 8 Como aviso

Motivo

Aplicando-se ModuleInitializerAttribute a um método dentro de uma biblioteca de classes.

Descrição da regra

Os inicializadores de módulo destinam-se a ser usados pelo código do aplicativo para garantir que os componentes de um aplicativo sejam inicializados antes que o código do aplicativo comece a ser executado. Se o código da biblioteca declarar um método com o ModuleInitializerAttribute, ele pode interferir na inicialização do aplicativo e também levar a limitações nas habilidades de corte desse aplicativo. O código da biblioteca não deve, portanto, utilizar o ModuleInitializerAttribute atributo.

Como corrigir violações

Em vez de usar métodos marcados com ModuleInitializerAttribute, a biblioteca deve expor métodos que podem ser usados para inicializar quaisquer componentes dentro da biblioteca e permitir que o aplicativo invoque o método durante a inicialização do aplicativo.

Quando suprimir avisos

É seguro suprimir avisos dessa regra se uma solução usar uma biblioteca de classes para fins de fatoração de código e o ModuleInitializerAttribute método não fizer parte de uma biblioteca ou pacote compartilhado ou distribuído.

Suprimir um aviso

Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar a regra.

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

Para desabilitar a regra para um arquivo, pasta ou projeto, defina sua severidade como none no arquivo de configuração.

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

Para desativar toda essa categoria de regras, defina a severidade da categoria como none no arquivo de configuração.

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

Para obter mais informações, consulte Como suprimir avisos de análise de código.

Consulte também