Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Visual Studio pode executar a análise de código do código gerenciado de duas maneiras: com a análise legada, também conhecida como análise estática FxCop de assemblies gerenciados, e com os analisadores de código mais modernos baseados na plataforma do compilador .NET. Este tópico aborda a análise de legado. Para saber mais sobre a análise de código baseada no .NET Compiler Platform, consulte Visão geral dos analisadores baseados na plataforma do compilador do .NET.
A análise de código para código gerenciado analisa assemblies gerenciados e relata informações sobre os assemblies, como violações das regras de programação e design definidas nas Diretrizes de Design do .NET.
A ferramenta de análise representa as verificações executadas durante uma análise como mensagens de aviso. As mensagens de aviso identificam problemas relevantes de programação e design e, quando possível, fornecem informações sobre como corrigir o problema.
Observação
Não há suporte para análise herdada (análise de código estático) para projetos .NET Core e .NET Standard no Visual Studio. Se você executar a análise de código em um projeto .NET Core ou .NET Standard como parte do msbuild, verá um erro semelhante ao erro: CA0055: não foi possível identificar a plataforma para <your.dll>. Para analisar código em projetos .NET Core ou .NET Standard, use analisadores de código.
Integração do IDE (ambiente de desenvolvimento integrado)
Você pode executar a análise de código em seu projeto manualmente ou automaticamente.
Para executar a análise de código sempre que você criar um projeto, selecione a opção na página de propriedades análise de código do projeto. Para obter mais informações, consulte Como habilitar e desabilitar a análise automática de código.
Para executar a análise de código manualmente em um projeto, na barra de menus, escolha Analisar>Executar Análise de Código>Executar Análise de Código no <projeto>.
Conjuntos de regras
As regras de análise de código para código gerenciado são agrupadas em conjuntos de regras. Você pode usar um dos conjuntos de regras padrão da Microsoft ou criar um conjunto de regras personalizado para atender a uma necessidade específica.
Suprimir avisos
Frequentemente, é útil indicar que um aviso não é aplicável. Isso informa ao desenvolvedor e a outras pessoas que podem examinar o código mais tarde que um aviso foi investigado e, em seguida, suprimido ou ignorado.
A supressão de avisos no código-fonte é implementada por meio de atributos personalizados. Para suprimir um aviso, adicione o atributo SuppressMessage ao código-fonte, conforme mostrado no exemplo a seguir:
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1039:ListsAreStrongTyped")]
Public class MyClass
{
// code
}
Para obter mais informações, consulte Suprimir avisos.
Observação
Se você migrar um projeto para o Visual Studio 2019, de repente poderá enfrentar um grande número de avisos de análise de código. Se você não estiver pronto para corrigir os avisos, poderá suprimir todos eles escolhendo Analisar>Construir e Suprimir Problemas Ativos.
Executar a análise de código como parte da política de check-in
Como uma organização, talvez você queira exigir que todos os check-ins atendam a determinadas políticas. Em particular, você deseja garantir que siga estas políticas:
Não há erros de build no código que está sendo verificado.
A análise de código é executada como parte do build mais recente.
Você pode fazer isso especificando políticas de check-in. Para obter mais informações, consulte Aprimoramento da qualidade do código com políticas de check-in do projeto.
Integração de build de equipe
Você pode usar os recursos integrados do sistema de build para executar a ferramenta de análise como parte do processo de build. Para obter mais informações, consulte Azure Pipelines.