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 definindoEnableNETAnalyzers
comofalse
.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ão2.9.x
mais recente doMicrosoft.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:
- Migrar da análise herdada para analisadores de .NET
- Migrar de analisadores do FxCop para analisadores de .NET