CA2255: El atributo ModuleInitializer no debe usarse en bibliotecas

  • Artículo
Propiedad Value
Identificador de la regla CA2255
Título El atributo ModuleInitializer no debe usarse en bibliotecas
Categoría Uso
La corrección es problemática o no problemática Poco problemático
Habilitado de forma predeterminada en .NET 8 Como advertencia

Causa

Aplicar ModuleInitializerAttribute a un método dentro de una biblioteca de clases.

Descripción de la regla

Los inicializadores de módulos están diseñados para que los utilice el código de aplicación para asegurarse de que los componentes de una aplicación se inicializan antes de que el código de aplicación empiece a ejecutarse. Si el código de biblioteca declara un método con ModuleInitializerAttribute, puede interferir con la inicialización de la aplicación y también limitar las capacidades de recorte de esa aplicación. Por lo tanto, el código de biblioteca no debe usar el atributo ModuleInitializerAttribute.

Cómo corregir infracciones

En lugar de usar métodos marcados con ModuleInitializerAttribute, una biblioteca debe exponer métodos que se pueden usar para inicializar cualquier componente dentro de la biblioteca y permitir que la aplicación invoque el método durante la inicialización de la aplicación.

Cuándo suprimir las advertencias

Es seguro suprimir las advertencias de esta regla si una solución usa una biblioteca de clases con fines de factorización de código y el método ModuleInitializerAttribute no forma parte de una biblioteca o paquete compartido o distribuido.

Supresión de una advertencia

Si solo quiere suprimir una única infracción, agregue directivas de preprocesador al archivo de origen para deshabilitar y volver a habilitar la regla.

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

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad en none del archivo de configuración.

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

Para deshabilitar toda esta categoría de reglas, establezca la gravedad de la categoría en none del archivo de configuración.

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

Para obtener más información, consulte Procedimiento para suprimir advertencias de análisis de código.

Vea también