Compartilhar via

Análise de código

Você pode usar analisadores de código para encontrar possíveis problemas no código do aplicativo .NET Framework. Os analisadores encontram possíveis problemas e sugerem correções para eles.

Os analisadores de código baseados em Roslyn são executados interativamente no Visual Studio enquanto você escreve seu código ou como parte de um build de CI. Você deve adicionar os analisadores ao seu projeto o mais cedo possível no ciclo de desenvolvimento. Quanto mais cedo você encontrar possíveis problemas em seu código, mais fácil será a correção. Os analisadores sinalizam problemas no código existente e alertam sobre novos problemas à medida que você continua o desenvolvimento.

Observação

Este artigo usa o pacote NuGet Microsoft.NetFramework.Analysisers agora preterido. A partir do .NET 5, os analisadores NET são incluídos no SDK do .NET. Se necessário, você pode usar o Microsoft.CodeAnalysis.NetAnalyzers NuGet package em vez disso. Para obter mais informações, consulte a análise de código no .NET.

Instalar e configurar analisadores

O Analisador do .NET Framework é entregue no pacote NuGet Microsoft.NetFramework.Analyzeers . Esse pacote fornece analisadores específicos das APIs do .NET Framework, que incluem analisadores de segurança. O pacote é incluído com o pacote Microsoft.CodeAnalysis.FxCopAnalyzers, portanto, se você instalar esse pacote, não será necessário instalar os analisadores do .NET Framework separadamente.

Instale o pacote NuGet em cada projeto em que você deseja que os analisadores executem. Apenas um desenvolvedor precisa adicioná-los ao projeto. O pacote do analisador é uma dependência de projeto e será executado em cada computador do desenvolvedor depois que ele tiver a solução atualizada.

Para instalar o pacote, clique com o botão direito do mouse no projeto e selecione "Gerenciar Dependências". No explorador do NuGet, pesquise "Microsoft. NetFramework.Analyzers". Instale a versão estável mais recente em todos os projetos em sua solução.

Use os analisadores

Depois que o pacote NuGet for instalado, crie sua solução. O analisador relatará todos os problemas localizados em sua base de código. Os problemas são relatados como avisos na janela Lista de Erros do Visual Studio, conforme mostrado na imagem a seguir:

Problemas relatados pelos analisadores do .NET Framework.

Ao escrever código, você vê linhas onduladas sob qualquer problema potencial existente nele. Passe o mouse sobre qualquer problema para obter mais informações e veja sugestões para qualquer possível correção, conforme mostrado na imagem a seguir:

Relatório interativo de problemas encontrados por analisadores de código.

Para obter mais informações, consulte a análise de código no Visual Studio.

Tipos de regras

Os analisadores examinam o código em sua solução e geram avisos com o prefixo CA. Para obter uma lista de todos os avisos possíveis, consulte regras de qualidade de código. Apenas alguns desses avisos se aplicam ao APIS do .NET Framework, incluindo:

Consulte também