Compartir a través de


Habilitación o instalación de analizadores de .NET propios

Los analizadores de .NET Compiler Platform (Roslyn) inspeccionan el código de C# o Visual Basic para supervisar la calidad del código y verificar si contiene problemas de estilo. Los analizadores de .NET de primera entidad son independientes de la plataforma de destino. Es decir, el proyecto no necesita tener como destino una plataforma .NET específica. Los analizadores funcionan para los proyectos que tienen net5.0 como destino, así como para versiones anteriores de .NET, como netcoreapp, netstandard y net472.

Puede habilitar o instalar los analizadores de .NET de primera entidad de una de las maneras siguientes:

  • Habilitar desde el SDK de .NET: a partir de Visual Studio 2019 16.8 y .NET 5.0, estos analizadores se incluyen con el SDK de .NET, que se incluye con Visual Studio. De forma predeterminada, el análisis está habilitado para los proyectos que tienen como destino .NET 5.0 o una versión posterior. Puede habilitar el análisis de código en los proyectos que tengan como destino versiones anteriores de .NET estableciendo la propiedad EnableNETAnalyzers de MSBUILD en true. También puede deshabilitar el análisis de código para el proyecto si establece EnableNETAnalyzers en false.

  • Instalar como un paquete NuGet: si no quiere cambiar al SDK de .NET 5 o versiones posteriores, o si prefiere un modelo basado en paquetes NuGet, los analizadores también están disponibles en el paquete NuGet Microsoft.CodeAnalysis.NetAnalyzers en Visual Studio 2019. Es posible que prefiera un modelo basado en paquetes para las actualizaciones de versión a petición. Si usa Visual Studio 2017, instale la versión 2.9.x más reciente del paquete NuGet Microsoft.CodeAnalysis.FxCopAnalyzers en su lugar.

Nota

Se recomienda habilitar los analizadores desde el SDK de .NET en lugar de instalar el paquete NuGet Microsoft.CodeAnalysis.NetAnalyzers, siempre que sea posible. La habilitación de los analizadores desde el SDK de .NET garantiza la obtención automática de las correcciones de errores del analizador y los nuevos analizadores en cuanto se actualiza el SDK. En el modelo de NuGet, tiene que actualizar el paquete NuGet cada vez que quiera corregir los errores más recientes. El paquete NuGet se actualiza con más frecuencia.

Migración a los analizadores de .NET

Si usa analizadores de FxCop heredados o analizadores de FxCop y quiere usar los analizadores de .NET, siga las instrucciones de los artículos siguientes: