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 directrices de diseño de .NET y las reglas de seguridad ayudan a evitar errores de seguridad. Puede configurar el nivel de gravedad de una categoría completa de reglas. También puede configurar opciones adicionales por 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 enumera 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
Establecer la gravedad de una categoría de reglas mediante la dotnet_analyzer_diagnostic.category-<category>.severity sintaxis 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 Categoría< AnalysisMode> para habilitar todas las reglas de una categoría.
Reglas de diseño
Reglas de documentación
|
Importancia |
|
Vínculo a reglas |
Reglas de documentación |
|
Descripción |
Las reglas de documentación admiten la escritura de 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
|
Importancia |
|
Vínculo a reglas |
Reglas de globalización |
|
Descripción |
Las reglas de globalización admiten aplicaciones y bibliotecas preparadas para el ámbito global. |
|
Valor de EditorConfig |
dotnet_analyzer_diagnostic.category-Globalization.severity |
|
Valor de la propiedad de MSBuild |
<AnalysisModeGlobalization> |
Reglas de portabilidad e interoperabilidad
|
Importancia |
|
Vínculo a reglas |
Reglas de portabilidad e interoperabilidad |
|
Descripción |
Las reglas de portabilidad admiten la portabilidad en distintas plataformas. Las reglas de interoperabilidad admiten la interacción con los clientes COM. |
|
Valor de EditorConfig |
dotnet_analyzer_diagnostic.category-Interoperability.severity |
|
Valor de la propiedad de MSBuild |
<AnalysisModeInteroperability> |
Reglas de mantenimiento
|
Importancia |
|
Vínculo a reglas |
Reglas de mantenimiento |
|
Descripción |
Las reglas de mantenimiento admiten el mantenimiento de aplicaciones y bibliotecas. |
|
Valor de EditorConfig |
dotnet_analyzer_diagnostic.category-Maintainability.severity |
|
Valor de la propiedad de MSBuild |
<AnalysisModeMaintainability> |
Reglas de nomenclatura
|
Importancia |
|
Vínculo a reglas |
Reglas de nomenclatura |
|
Descripción |
Las reglas de nomenclatura admiten el cumplimiento de las convenciones de nomenclatura de las directrices de diseño de .NET. |
|
Valor de EditorConfig |
dotnet_analyzer_diagnostic.category-Naming.severity |
|
Valor de la propiedad de MSBuild |
<AnalysisModeNaming> |
|
Importancia |
|
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
|
Importancia |
|
Vínculo a reglas |
Reglas de SingleFile |
|
Descripción |
Las reglas de archivo único admiten aplicaciones de archivo único. |
|
Valor de EditorConfig |
dotnet_analyzer_diagnostic.category-SingleFile.severity |
|
Valor de la propiedad de MSBuild |
<AnalysisModeSingleFile> |
Reglas de confiabilidad
|
Importancia |
|
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
|
Importancia |
|
Vínculo a reglas |
Reglas de seguridad |
|
Descripción |
Las reglas de seguridad apoyan bibliotecas y aplicaciones más seguras. Estas reglas ayudan a evitar 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
|
Importancia |
|
Vínculo a reglas |
Reglas de estilo |
|
Descripción |
Las reglas de estilo admiten un 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 editorConfig para habilitar las siguientes reglas: IDE0051, IDE0052, IDE0064 y IDE0076. Aunque estas reglas comienzan con "IDE", no forman parte técnica de la Style categoría.
Reglas de uso
|
Importancia |
|
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> |
