Partilhar via

Análise de código

Você pode usar analisadores de código para encontrar possíveis problemas em seu código de aplicativo .NET Framework. Os analisadores encontram problemas potenciais 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 uma compilação 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á corrigi-los. 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.Analyzers agora obsoleto. A partir do .NET 5, os analisadores NET estão incluídos no SDK do .NET. Se necessário, pode-se utilizar o Microsoft.CodeAnalysis.NetAnalyzers NuGet package. Para obter mais informações, consulte Análise de código no .NET.

Instalar e configurar analisadores

O .NET Framework Analyzer é fornecido no pacote NuGet Microsoft.NetFramework.Analyzers . Este pacote fornece analisadores específicos para APIs do .NET Framework, que incluem analisadores de segurança. O pacote está incluído no pacote Microsoft.CodeAnalysis.FxCopAnalyzers, portanto, se você instalar esse pacote, não há necessidade de instalar os analisadores do .NET Framework separadamente.

Instale o pacote NuGet em todos os projetos em que você deseja que os analisadores sejam executados. Apenas um desenvolvedor precisa adicioná-los ao projeto. O pacote do analisador é uma dependência do projeto e será executado na máquina de cada desenvolvedor assim que 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, procure "Microsoft.NetFramework.Analyzers". Instale a versão estável mais recente em todos os projetos da sua solução.

Use os analisadores

Depois que o pacote NuGet estiver instalado, crie sua solução. O analisador relatará quaisquer problemas que localizar 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.

À medida que você escreve código, você vê rabiscos abaixo de qualquer problema potencial em seu código. Passe o cursor sobre qualquer problema para obter mais informações e ver 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 Análise de código no Visual Studio.

Tipos de regras

Os analisadores examinam o código na sua solução e exibem avisos com um CA de prefixo. Para obter uma lista de todos os avisos possíveis, consulte Regras de qualidade de código. Apenas alguns desses avisos se aplicam às APIs do .NET Framework, incluindo:

Ver também