Exemplo do ATLTraceTool: Exibe saída do ATLTRACE2

  • Artigo

O exemplo ATLTraceTool cria um aplicativo que especifica qual ATLTRACE2 mensagens são exibidas na janela de saída.Esse aplicativo, a ferramenta de rastreamento ATL, exiba mensagens de rastreamento de depurar nas fontes de ATL e MFC.Você pode controlar o tipo e a quantidade de mensagens exibidas.

AtlTraceTool.exe é fornecido no Visual Studio e pode ser encontrado no diretório \programa Files\Microsoft Visual Studio 9.0\Common7\Tools.AtlTraceTool.exe também está disponível a partir de Ferramentas menu no ambiente de desenvolvimento.

Observação de segurança:

Este código de exemplo é fornecido para ilustrar um conceito e não deve ser usado em aplicativos ou sites da Web, pois ele não pode ilustrar sistema autônomo práticas de codificação mais seguras.Microsoft sistema autônomo sumes nenhuma responsabilidade por danos incidentais ou conseqüenciais deve o código de exemplo ser usado para fins diferentes de sistema autônomo se destina.

Para obter exemplos e instruções para instalá-los:

  • Sobre o Visual Studio Ajuda menu, clicar Exemplos.

    Para obter mais informações, consulte Localizando arquivos de exemplo.

  • A versão mais recente e a lista completa das Exemplos está disponível online a partir de O Visual Studio 2008 Exemplos página.

  • Você também pode localizar exemplos no disco rígido do seu computador.Por padrão, exemplos e um arquivo Leiame são copiados para uma pasta sob \programa Files\Visual Studio 9.0\Samples\.Para edições Express do Visual Studio, todos os exemplos estão localizados online.

Criando e executando o exemplo

Para compilação e executar esse exemplo

  1. Abra a solução arquivo tracetool.sln.

  2. From a Compilação menu, clicar Compilação.

  3. From a Depurar menu, clicar Iniciar sem depuração.

Observação:

Esse procedimento é opcional.Você pode usar AtlTraceTool.exe predefinidos em vez disso, se você desejar.

Para usar ATLTraceTool.exe

  1. Depurar um projeto MFC ou ATL, clicando em Iniciar from the Depurar menu.

  2. From a Ferramentas menu, clicar Ferramenta de rastreamento do MFC/ATL se ele é não estiver sendo executado.

  3. expandir a lista de controle de árvore no Lista de rastreamento janela.A janela mostra o aplicativo em execução, todos os módulos no aplicativo e as categorias de rastreamento para cada módulo.

  4. Personalizar, para cada processo, módulo e categoria, as informações que serão exibidas na janela de saída.The Nível de rastreamento controle de a Processo agrupar está relacionado à ATLTRACE2 nível; somente as ATLTRACE2 as mensagens com um nível igual ou maior que a configuração dos Nível de rastreamento controle será exibido na janela de saída.

  5. clicar Aplicar para colocar as configurações entrem em vigor.

Você pode salvar suas configurações e carregá-los na próxima vez que você depure o aplicativo; use o Salvar and Carga botões.

Interface de usuário de ferramenta Trace ATL

  • Lista de rastreamento
    Um controle de árvore com uma lista de processos que usam ATL/MFC fontes de depurar.Em cada processo, módulos estão listados e em cada módulo, categorias de rastreamento são listadas.

  • Atualizar
    Atualiza a lista de processos e módulos em Lista de rastreamento.

  • agrupar de processo
    Configurações de todo o processo:

    Nível de rastreamento – Equates para o parâmetro de nível de rastreamento em chamadas para ATLTRACE2.Atualmente, as fontes da ATL/MFC usam um nível de rastreamento 0–4, onde 0 é o nível mais importante.

    Ativado – Permite que o rastreamento para o processo.

    Nomes de categoria e função – Incluirá o nome de categoria e a função de rastreamento de mensagens de rastreamento.

    nome de arquivo & Linha nº – Inclui o arquivo de nome e o número de linha em mensagens de rastreamento.

  • Módulo de agrupar
    Você deve primeiro selecionar um módulo no Lista de rastreamento controle de árvore antes de é ativado neste agrupar.Essas configurações afetam o módulo.

    Nível de rastreamento – Equates para o parâmetro de nível de rastreamento em chamadas para ATLTRACE2. Atualmente, as fontes da ATL/MFC usam um nível de rastreamento 0–4, onde 0 é mais importante.

    Herdar de processo – Permite configurações de rastreamento no Processo agrupar também seja usado para este módulo.

    Ativado – Permite que o rastreamento para esse módulo.

    desabilitado – Desativa o rastreamento para esse módulo.

  • agrupar de categoria
    Você deve primeiro selecionar uma categoria no Lista de rastreamento controle de árvore antes de é ativado neste agrupar.Essas configurações afetam a categoria dentro do módulo.

    Nível de rastreamento – Equates para o parâmetro de nível de rastreamento em chamadas para ATLTRACE2.Atualmente, as fontes da ATL/MFC usam um nível de rastreamento 0–4, onde 0 é mais importante.

    Herdar de módulo – Permite configurações de rastreamento no Module agrupar também seja usado para esta categoria.

    Ativado – Permite que o rastreamento para esta categoria.

    desabilitado – Desativa o rastreamento para esta categoria.

  • Salvar
    Salva as configurações para o processo corrente e todos os módulos abaixo dele em um arquivo .trc.O arquivo .trc pode ser carregado usando o Carga botão ou chamando AtlTraceLoadSettings do projeto.Se o arquivo .trc estiver localizado no mesmo diretório do EXE/DLL, você pode chamar AtlTraceLoadSettings e passe um nulo para nome de arquivo.

  • Carga
    Carrega um arquivo .trc.

  • Aplicar
    Aplica as configurações corrente para o processo carregado.

  • Fechar
    Fecha o Ferramenta de rastreamento ATL/MFC caixa de diálogo.As alterações não terão efeito a menos que Aplicar foi selecionado.

  • Help
    Exibe ajuda.

Consulte também

Outros recursos

Exemplos do ATL