Compartilhar via


Habilitar ou instalar analisadores .NET internos

Os analisadores do .NET Compiler Platform (Roslyn) inspecionam código em C# ou no Visual Basic em busca de problemas de estilo e de qualidade. Analisadores .NET internos são independentes da plataforma de destino. Ou seja, o projeto não precisa ser destinado a uma plataforma específica do .NET. Os analisadores funcionam para projetos direcionados a net5.0 e a versões anteriores do .NET, como netcoreapp, netstandard e net472.

Você pode habilitar ou instalar os analisadores .NET internos de uma das seguintes maneiras:

  • Habilitar a partir do SDK do .NET: a partir do Visual Studio 2019 16.8 e do .NET 5.0, esses analisadores estão incluídos no SDK do .NET, que está incluído no Visual Studio. A análise está habilitada, por padrão, para projetos direcionados ao .NET 5.0 ou posterior. É possível habilitar a análise de código em projetos direcionados a versões anteriores do .NET definindo a propriedade EnableNETAnalyzers de MSBUILD como true. Também é possível desabilitar a análise de código do projeto definindo EnableNETAnalyzers como false.

  • Instalar como um pacote NuGet: se você não quer mudar para o SDK do .NET 5+ ou se prefere um modelo baseado em Microsoft.CodeAnalysis.NetAnalyzers pacote NuGet, os analisadores também estão disponíveis no pacote NuGet no Visual Studio 2019. Talvez você prefira um modelo baseado em pacote para atualizações de versão sob demanda. Se estiver no Visual Studio 2017, instale a versão 2.9.x mais recente do Microsoft.CodeAnalysis.FxCopAnalyzers pacote NuGet.

Observação

É recomendável habilitar os analisadores no SDK do .NET em vez de instalar o Microsoft.CodeAnalysis.NetAnalyzers pacote NuGet, quando possível. Habilitar os analisadores no SDK do .NET garante que você obtenha automaticamente as correções de bug do analisador e os novos analisadores assim que atualizar o SDK. No modelo NuGet, você precisará atualizar o pacote NuGet sempre que quiser as correções de bug mais recentes. O pacote NuGet é atualizado com mais frequência.

Migrar para analisadores de .NET

Se você estiver usando analisadores FxCop herdados ou analisadores FxCop e quiser usar os analisadores .NET, siga as instruções dos artigos a seguir: