Categorías de las reglas

Cada regla de análisis de código pertenece a una categoría de reglas. Por ejemplo, las reglas de diseño admiten el cumplimiento de las instrucciones de diseño de .NET y las reglas de seguridad ayudan a evitar los errores de seguridad. Puede configurar el nivel de gravedad de una categoría completa de reglas. También puede configurar opciones adicionales en cada categoría.

En la tabla siguiente se muestran las distintas categorías de reglas de análisis de código y se proporciona un vínculo a las reglas de cada categoría. También se muestra el valor de configuración que se va a usar en un archivo EditorConfig para configurar de forma masiva la gravedad de la regla por categoría. Por ejemplo, para establecer la gravedad de las infracciones de reglas de seguridad como errores, la entrada EditorConfig es dotnet_analyzer_diagnostic.category-Security.severity = error.

Sugerencia

El establecimiento de la gravedad de una categoría de reglas con la sintaxis dotnet_analyzer_diagnostic.category-<category>.severity no se aplica a las reglas que están deshabilitadas de forma predeterminada. Sin embargo, a partir de .NET 6, puede usar la propiedad de proyecto AnalysisMode<Category> para habilitar todas las reglas de una categoría.

Reglas de diseño

Valor
Vínculo a reglas Reglas de diseño
Descripción Las reglas de diseño admiten el cumplimiento de las instrucciones de diseño de .NET Framework.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Design.severity
Valor de la propiedad de MSBuild <AnalysisModeDesign>

Reglas de documentación

Valor
Vínculo a reglas Reglas de documentación
Descripción Las reglas de documentación permiten escribir bibliotecas bien documentadas mediante el uso correcto de comentarios de documentación XML para API visibles externamente.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Documentation.severity
Valor de la propiedad de MSBuild <AnalysisModeDocumentation>

Reglas de globalización

Valor
Vínculo a reglas Reglas de globalización
Descripción Las reglas de globalización admiten aplicaciones y bibliotecas de uso internacional.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Globalization.severity
Valor de la propiedad de MSBuild <AnalysisModeGlobalization>

Reglas de portabilidad e interoperabilidad

Valor
Vínculo a reglas Reglas de portabilidad e interoperabilidad
Descripción Las reglas de portabilidad admiten la portabilidad en diferentes plataformas. Las reglas de interoperabilidad admiten la interacción con clientes COM.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Interoperability.severity
Valor de la propiedad de MSBuild <AnalysisModeInteroperability>

Reglas de mantenimiento

Valor
Vínculo a reglas Reglas de mantenimiento
Descripción Las reglas de mantenimiento admiten el mantenimiento de bibliotecas y aplicaciones.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Maintainability.severity
Valor de la propiedad de MSBuild <AnalysisModeMaintainability>

Reglas de nomenclatura

Valor
Vínculo a reglas Reglas de nomenclatura
Descripción Las reglas de nomenclatura admiten el cumplimiento de las convenciones de nomenclatura de la instrucciones de diseño de .NET.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Naming.severity
Valor de la propiedad de MSBuild <AnalysisModeNaming>

Reglas de rendimiento

Valor
Vínculo a reglas Reglas de rendimiento
Descripción Las reglas de rendimiento admiten aplicaciones y bibliotecas de alto rendimiento.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Performance.severity
Valor de la propiedad de MSBuild <AnalysisModePerformance>

Reglas de SingleFile

Valor
Vínculo a reglas Reglas de SingleFile
Descripción Las reglas de archivo único admiten aplicaciones de un solo archivo.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-SingleFile.severity
Valor de la propiedad de MSBuild <AnalysisModeSingleFile>

Reglas de confiabilidad

Valor
Vínculo a reglas Reglas de confiabilidad
Descripción Las reglas de confiabilidad admiten la confiabilidad de bibliotecas y aplicaciones, como el uso correcto de la memoria y los subprocesos.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Reliability.severity
Valor de la propiedad de MSBuild <AnalysisModeReliability>

Reglas de seguridad

Valor
Vínculo a reglas Reglas de seguridad
Descripción Las reglas de seguridad admiten bibliotecas y aplicaciones más seguras. Estas reglas ayudan a evitar los errores de seguridad en el programa.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Security.severity
Valor de la propiedad de MSBuild <AnalysisModeSecurity>

Reglas de estilo

Valor
Vínculo a reglas Reglas de estilo
Descripción Las reglas de estilo admiten el estilo de código coherente en el código base. Estas reglas comienzan con el prefijo "IDE".*
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Style.severity
Valor de la propiedad de MSBuild <AnalysisModeStyle>

* Use el valor dotnet_analyzer_diagnostic.category-CodeQuality.severity de EditorConfig para habilitar las siguientes reglas: IDE0051, IDE0052, IDE0064 y IDE0076. Aunque estas reglas comienzan por "IDE", técnicamente no forman parte de la categoría Style.

Reglas de uso

Valor
Vínculo a reglas Reglas de uso
Descripción Las reglas de uso admiten el uso adecuado de .NET.
Valor de EditorConfig dotnet_analyzer_diagnostic.category-Usage.severity
Valor de la propiedad de MSBuild <AnalysisModeUsage>