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.
Las reglas de documentación permiten escribir bibliotecas bien documentadas mediante el uso correcto de comentarios de documentación XML para API visibles externamente.
* 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.
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
