CA2255: El atributo ModuleInitializer no debe usarse en bibliotecas
| 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.
