Coletando informações de IntelliTrace

Este tópico se aplica a Visual Studio 2010 Ultimate somente.

IntelliTrace é ativada por padrão em Visual Studio 2010 Ultimate. Durante uma sessão de depuração ao vivo, IntelliTrace funciona em segundo plano, a coleta de informações de IntelliTrace automática e invisível. A disponibilidade dessas informações permite que você alternar de sessão de depuração ao vivo para depuração com IntelliTrace e o "tempo de viagem" por meio de seu código.

Por padrão, o IntelliTrace coleta e registra informações selecionada eventos de IntelliTrace somente. As configurações de coleção padrão têm sobrecarga mínima. Elas não afetam a execução do seu aplicativo ou a sua capacidade de usar o depurador de Visual Studio.

Coleta de chamadas e os parâmetros permite IntelliTrace fornecer recursos adicionais de depuração. No entanto, coleta de chamadas e os parâmetros será aumentar a sobrecarga de desempenho, use o espaço em disco adicional e desativar a edição e continuar o recurso do depurador Visual Studio. Você deve avaliar os custos e benefícios para seu aplicativo em particular e o cenário de depuração.

Opções de coleção são definidas no nível de Visual Studio. Eles se aplicam a todos os Visual Basic e C# de projetos e soluções. Opções de coleta persistem entre sessões de depuração e sessões de Visual Studio.

Neste tópico.

• Salvando arquivos de Log

• Eventos de IntelliTrace

• Parâmetros e chamadas

• Configurar a coleta de módulo

Salvando arquivos de Log

Por padrão, IntelliTrace não salva arquivos de log de IntelliTrace (arquivos de .itrace) depois que você feche Visual Studio. Você pode alterar o comportamento padrão para habilitar IntelliTrace salvar todos os arquivos de log, ou você pode salvar manualmente os arquivos de log IntelliTrace, conforme descrito nos procedimentos a seguir.

Para alterar o comportamento do arquivo de log IntelliTrace

1. No menu Tools, clique em Options.

2. Na lista de categorias de opções, expanda o IntelliTrace nó e clique em Advanced.

3. Execute uma das seguintes tarefas:

   1. Se você desejar salvar todos os arquivos de log de IntelliTrace (.iTrace de arquivos), selecione IntelliTrace de armazenamento de gravações nesse diretório e especifique o caminho para a pasta na qual você deseja que os arquivos sejam salvos.

   2. Se você deseja que os arquivos de .itrace a ser excluído ao fechar Visual Studio , a menos que você manualmente salvá-los, desmarque gravações de IntelliTrace de armazenamento nesse diretório.

4. Clique OK para salvar suas alterações.

Salvar manualmente um arquivo de log IntelliTrace

1. Clique o Salvar a sessão atual do IntelliTrace botão na barra de ferramentas do IntelliTrace janela.

2. No Salvar como caixa de diálogo, especifique o nome do arquivo ao qual você deseja salvar a sessão e clique Salvar.

Eventos de IntelliTrace

IntelliTrace são eventos que ocorrem durante a execução do seu aplicativo, que pode ser coletada pelo IntelliTrace. Tipos de eventos que possam ser coletados pelo IntelliTrace são como segue:

• O depurador de eventos. Esses são os eventos que ocorrem dentro do depurador Visual Studio, enquanto você depurar seu aplicativo. A inicialização do seu aplicativo é um evento de depurador. Outros eventos de depurador são Parando eventos, que são eventos que fazem com que o seu aplicativo para entrar em um estado de interrupção. Alcançar um ponto de interrupção, atingindo um tracepoint ou executar um Etapa comando são exemplos de eventos de interrupção.

  Por motivos de desempenho, o IntelliTrace não coleta todos os valores possíveis para cada evento do depurador. Em vez disso, o IntelliTrace coleta os valores que são visíveis para o usuário. Se o Autos janela estiver aberta, por exemplo, o IntelliTrace coleta os valores que são visíveis no Autos janela. Se o Autos janela é fechada, esses valores não são coletados.

  Se você apontar para uma variável em uma janela de origem, o valor que aparece no DataTip é coletado. No entanto, o valores em um DataTip fixado não são coletadas.

• Eventos de exceção. Esses ocorrem para exceções controladas, nos pontos onde a exceção é capturada e e para exceções não tratadas. IntelliTrace coleta o tipo de exceção e a mensagem de exceção.

• Eventos do Framework. Esses ocorrem dentro do.Biblioteca de rede. Você pode exibir uma lista completa de.NET eventos que podem ser coletados no Eventos de IntelliTrace página da Opções caixa de diálogo. Os dados coletados pelos IntelliTrace variam por evento. Para um Acesso ao arquivo coleta de eventos, IntelliTrace o nome do arquivo. para um Caixa de seleção Verificar, ele coleta o estado da caixa de seleção e o texto; e assim por diante.

Para ver uma lista de eventos de IntelliTrace que foram coletados, clique o Eventos de IntelliTrace guia da IntelliTrace janela. Eventos de depurador sempre são coletados quando IntelliTrace está habilitado. Você não pode desativar sua coleção.

Mais comuns.Eventos de Framework são coletados por padrão. Você pode usar o procedimento a seguir para selecionar outro.NET eventos. Além disso, você pode desativar a coleção de todos os.NET eventos. Para diminuir a confusão na IntelliTrace janela, talvez você queira desativar a coleta de eventos que não lhe interessam. Ativando ou desativando a coleta de eventos específicos geralmente tem pouco efeito no desempenho do aplicativo.

Para escolher quais eventos de IntelliTrace que você deseja registrar

1. Sobre o IntelliTrace barra de ferramentas da janela, clique no Abrir configurações de IntelliTrace ícone.

   – ou –

   1. No menu Tools, clique em Options.

   2. No Opções caixa de diálogo, aponte para o IntelliTrace nó e clique Geral.

2. Verifique Habilitar IntelliTrace está selecionada.

   Observação
   Limpando o Habilitar IntelliTrace caixa de seleção desativa todas as configurações personalizadas.

3. Sob o IntelliTrace o nó, clique em Eventos de IntelliTrace.

4. Examinar o Eventos de IntelliTrace caixa para localizar as categorias de eventos que você está interessado.

   1. Para ver os eventos individuais, clique no controle de árvore ao lado do categoria nome. Por exemplo, você pode expandir registro para ver os eventos do Registro específicas, como ClosedRegistryKey.

   2. Para ativar ou desativar a gravação de uma categoria inteira de eventos, marque ou desmarque a caixa de seleção ao lado do nome da categoria.

   3. Para ativar ou desativar a gravação de um evento específico, marque ou desmarque a caixa de seleção ao lado do nome do evento específico.

5. Clique em OK.

6. Se você estiver depurando, você deve reiniciar a sessão de depuração para que as alterações tenham efeito.

Parâmetros e chamadas

Se você precisar obter mais informações, durante a depuração com IntelliTrace, você pode optar por coletar informações sobre chamadas e seus parâmetros. Coletando informações podem ter implicações de desempenho para o seu aplicativo e podem aumentar o tamanho de seus arquivos de log de chamada.

Coletando informações de chamada é incompatível com o recurso Edit and Continue do depurador Visual Studio. Se você optar por coletar informações, editar e continuar é automaticamente desativado e não pode ser reativadas durante a coleta de informações de chamada de chamada está ativado.

Quando você habilita IntelliTrace de eventos e informações de chamar, IntelliTrace um registro de cada chamada de entrada e saída de coleta. Na entrada, o IntelliTrace coleta informações de nome e valor para cada parâmetro. Arrays, somente os primeiros 256 objetos são registrados. Para objetos, somente o nível superior da estrutura é registrado. Ao sair, IntelliTrace coleta o valor de retorno do método.

Para habilitar a coleta de informações de chamada

1. No Opções caixa de diálogo na IntelliTrace nó, clique em Geral.

2. Sobre o Geral página, clique em IntelliTrace de eventos e informações de chamar.

3. Clique em OK.

Configurar a coleta de módulo

Você pode ativar a coleta de informações de IntelliTrace ou desativar para módulos específicos. Essa capacidade é útil, pois determinados módulos não podem ser interessantes para fins de depuração. Por exemplo, você pode depurar uma solução que inclui projetos herdados da DLL que estão bem testados e depurados completamente. Excluir os módulos que não lhe interessam reduz a desordem na IntelliTrace janela e torna mais fácil para se concentrar no código interessante. Ele também pode melhorar o desempenho e reduzir o espaço em disco usado pelo arquivo de log. A diferença pode ser significativa se você tiver escolhido para coletar as chamadas e os parâmetros.

Para coletar dados dos módulos selecionados

1. No Opções caixa de diálogo na IntelliTrace nó, clique em módulos.

2. Selecione coletar dados de todos os módulos, exceto o seguinte ou coletar dados de apenas os seguintes módulos.

   Embaixo do que a configuração é uma lista de nomes de módulo.

3. Para remover um módulo na lista, selecione o nome do módulo e clique no Remover botão.

4. Para adicionar um módulo à lista:

   1. Clique no botão Add.

      O Adicionar um padrão caixa de diálogo aparece.

   2. No Enter um padrão de seqüência de caracteres para corresponder , digite o nome do módulo que você deseja adicionar à lista. Para adicionar mais de um módulo, você pode usar os especificadores de caractere curinga no início ou fim da string.

   3. Clique em Adicionar.

   Os nomes de módulo devem ser nomes de arquivo, não os nomes de assembly. Caminhos de arquivo não são aceitos.

5. Clique em OK.

   Observação
   Se a coleção é definida como somente os eventos na Geral página, configurações de módulos não terão efeito.

Consulte também

Conceitos

Depuração com IntelliTrace