Recursos do IntelliTrace (C#, Visual Basic, C++)

Você pode usar o IntelliTrace para registrar eventos e chamadas de método seu aplicativo, o que permite examinar seu estado (pilha de chamadas e valores de variáveis locais) em diferentes pontos da execução. Basta começar a depuração como de costume - o IntelliTrace está ativado por padrão e você pode ver as informações que o IntelliTrace está gravando na nova janela Ferramentas de diagnóstico na guia Eventos . Selecione um evento e clique em Ativar depuração histórica para ver a pilha de chamadas e os locais gravados para esse evento.

Para obter uma descrição passo a passo, consulte Passo a passo: Usando o IntelliTrace.

O IntelliTrace está disponível no Visual Studio Enterprise edition, mas não nas edições Visual Studio Professional ou Community.

Para confirmar se o IntelliTrace está ativado, abra a página Opções > de ferramentas > do IntelliTrace. Ativar IntelliTrace deve ser verificado por padrão.

Observação

O escopo de todas as configurações na página de opções do IntelliTrace é o Visual Studio como um todo, não projetos ou soluções individuais. Uma alteração nessas configurações se aplica a todas as instâncias do Visual Studio, todas as sessões de depuração e todos os projetos ou soluções.

Escolha os eventos que o IntelliTrace registra (C#, Visual Basic)

Você pode ativar ou desativar a gravação para eventos específicos do IntelliTrace.

Se você estiver depurando, pare de depurar. Vá para Opções de Ferramentas >> IntelliTrace > Eventos IntelliTrace. Escolha os eventos que deseja que o IntelliTrace registre.

Coletar instantâneos (C#, Visual Basic, C++)

Isso não é habilitado por padrão, mas o IntelliTrace pode capturar instantâneos do seu aplicativo em cada ponto de interrupção e evento de etapa do depurador, e você pode visualizar esses instantâneos em uma sessão de depuração histórica. Um instantâneo fornece uma visão do estado completo do aplicativo. Para habilitar a captura de snapshots, vá para Tools > Options > IntelliTrace > General e selecione IntelliTrace snapshots (gerenciados e nativos). Para obter mais informações, consulte Inspecionar estados anteriores do aplicativo usando o IntelliTrace.

Os instantâneos estão disponíveis no Visual Studio Enterprise 2017 versão 15.5 e superior e requerem o Windows 10 Anniversary Update ou superior. Para aplicativos .NET Core e ASP.NET Core, é necessário o Visual Studio Enterprise 2017 versão 15.7. Para aplicativos nativos destinados ao Windows, é necessário o Visual Studio Enterprise 2017 versão 15.9 Preview 2.

Coletar eventos do IntelliTrace e informações de chamada (C#, Visual Basic)

Isso não está habilitado por padrão, mas o IntelliTrace pode gravar chamadas de método junto com eventos. Para habilitar a coleta de chamadas de método, vá para Opções de ferramentas >>, IntelliTrace > Geral e selecione Eventos e informações de chamada do IntelliTrace (somente gerenciados).

As informações de chamada não estão atualmente disponíveis para aplicativos .NET Core e ASP.NET Core.

Isso permite que você possa ver o histórico da pilha de chamadas e navegue para trás e para frente nas chamadas no seu código. O IntelliTrace regista dados como nomes de métodos, pontos de entrada e saída de métodos e determinados valores de parâmetros e valores de retorno.

Sugestão

Esta opção não está habilitada por padrão porque adiciona uma sobrecarga considerável. O IntelliTrace não só tem de intercetar todos os métodos que a sua aplicação faz, como também tem de lidar com um conjunto muito maior de dados quando se trata de os mostrar no ecrã ou de os manter no disco.

Você pode reduzir a sobrecarga de desempenho restringindo a lista de eventos que o IntelliTrace registra e mantendo o número de módulos coletados ao mínimo. Para obter mais informações, consulte Controlar a quantidade de informações de chamada que o IntelliTrace registra.

Você pode usar a calha de navegação que aparece à esquerda da janela de código. Se não vir a calha de navegação, aceda a Ferramentas > Opções > IntelliTrace > Avançado e selecione Mostrar a calha de navegação enquanto estiver no modo de depuração.

A barra de navegação permite-lhe navegar para a frente e para trás através de chamadas de métodos e eventos no modo histórico de depuração. Para obter mais informações sobre depuração histórica, consulte Depuração histórica. Tem uma série de comandos:

Command	Description
Defina o contexto do depurador aqui	Defina o contexto de depuração para o intervalo de tempo da chamada onde este aparece. Este ícone aparece apenas na pilha de chamadas atual.
Voltar ao Site de Chamada	Mova o ponteiro e o contexto de depuração de volta para o local onde a função corrente foi chamada. Se você estiver no modo de Depuração ao Vivo, este comando ativará a Depuração Histórica. Se você navegar de volta para a interrupção de execução original, a Depuração Histórica será desativada e a Depuração em Tempo Real será ativada.
Ir para Chamada Anterior ou Evento IntelliTrace	Mova o ponteiro e o contexto de depuração de volta para a chamada ou evento anterior. Se você estiver no modo de Depuração ao Vivo, esse comando ativará a Depuração Histórica.
Entre	Entre na função selecionada no momento. Este comando está disponível apenas quando está no modo de Depuração Histórica.
Ir para Próxima Chamada ou Evento IntelliTrace	Mova o ponteiro e o contexto de depuração para a próxima chamada ou evento para o qual existem dados do IntelliTrace. Este comando está disponível apenas quando estás no modo de depuração histórica.
Ir para o Modo Ao Vivo	Volte ao modo de depuração em tempo real.

Procurar uma linha ou método no IntelliTrace

Você pode pesquisar métodos somente quando as informações de chamada de método tiverem sido habilitadas. Você pode pesquisar no histórico do IntelliTrace por uma linha ou método específico. Enquanto a execução do depurador é interrompida, clique com o botão direito do mouse dentro do corpo da função para ver o menu de contexto e clique em Pesquisar por esta linha no IntelliTrace ou Pesquisar por este método no IntelliTrace.

Controlar a quantidade de informações de chamada que o IntelliTrace regista

Por padrão, o IntelliTrace registra informações de todos os módulos usados pela sua solução. Você pode configurar o IntelliTrace para gravar informações de chamadas somente para os módulos que lhe interessam. Em Opções de Ferramentas >> Módulos IntelliTrace>, Você pode especificar os módulos a serem incluídos ou os módulos a serem excluídos do IntelliTrace. O IntelliTrace coletará apenas os eventos originados dos módulos que você especificou e as chamadas de método que aconteceram dentro dos módulos nos quais você está interessado.

Para adicionar vários módulos, use o caractere curinga * no início ou no final da cadeia de caracteres. Para nomes de módulo, use nomes de arquivo, não nomes de assembly. Caminhos de arquivo não são aceitos.

Tente manter o número de módulos a um mínimo. Você obtém um melhor desempenho porque há menos dados a serem coletados. Você também tem menos ruído na IU porque há menos dados para analisar.

Salvar dados do IntelliTrace em arquivo (C#, Visual Basic, C++)

Você pode salvar os dados que o IntelliTrace coletou indo para Depurar > IntelliTrace > Salvar sessão do IntelliTrace enquanto estiver depurando e o aplicativo estiver em um estado de interrupção. O item de menu está desativado e você não poderá salvar os dados que o IntelliTrace coletou se o aplicativo ainda estiver em execução ou se você tiver parado de depurar.

Você pode configurar o IntelliTrace para salvar automaticamente em um arquivo indo para Opções de Ferramentas >> IntelliTrace > Advanced e selecionando Armazenar gravações IntelliTrace neste diretório. Você também pode configurar um tamanho definido para o arquivo gerado, o que faz com que o IntelliTrace grave sobre dados mais antigos quando fica sem espaço. O Visual Studio cria dois arquivos para cada sessão do IntelliTrace quando eles são salvos automaticamente e o processo de hospedagem do Visual Studio (vshost.exe) está ativado.

Sugestão

Para economizar espaço em disco, desative o salvamento automático de arquivos quando não precisar mais deles. Os ficheiros existentes não serão eliminados. Você pode sempre guardar num ficheiro por demanda no menu de contexto.

Quando guarda dados do IntelliTrace no ficheiro, obtém um ficheiro .itrace para cada processo a partir do qual o IntelliTrace recolheu. Em seguida, você pode abrir o arquivo .itrace no Visual Studio indo para Arquivo > Aberto > e selecionando o arquivo .itrace na caixa de diálogo Abrir Arquivo. Para obter mais informações, consulte Usando dados salvos do IntelliTrace.