Informações de log na janela Saída usando pontos de rastreamento no Visual Studio

O programa de exemplo a seguir é um loop for simples com uma variável de contador que aumenta um cada vez que o loop executa outra iteração.

O programa de exemplo a seguir é um loop for simples com uma variável de contador que aumenta um cada vez que o loop executa outra iteração.

using System.Diagnostics;

namespace Tracepoints
{
    public class Program
    {
        public static void Main(string[] args)
        {
            int counter = 0;
            for (int i=0; i<=10; i++)
            {
                counter +=1;
            }
        }
    }
}

Você pode definir pontos de rastreamento especificando uma cadeia de caracteres de saída na caixa de seleção Ação na janela Configurações do Ponto de Interrupção.

1. Para inicializar um ponto de rastreamento, primeiro clique na sarjeta à esquerda do número de linha em que você deseja definir o ponto de rastreamento.

   

2. Passe o mouse sobre o círculo vermelho e clique no ícone de engrenagem.

3. Essa ação abre a janela Configurações do Ponto de Interrupção.

   

4. Marque a caixa de seleção Ação.

   

   Observe como o círculo vermelho muda para um diamante indicando que você alternou de um ponto de interrupção para um ponto de rastreamento.

5. Insira a mensagem que você deseja fazer logon na caixa de texto Mostrar uma mensagem na Janela de Saída (para obter detalhes, consulte seções posteriores neste artigo).

   Agora, seu ponto de rastreamento está definido. Pressione o botão "Fechar" se tudo o que você deseja fazer é registrar algumas informações na Janela de Saída.

6. Se você quiser adicionar condições que determinem se sua mensagem é exibida, marque a caixa de seleção Condições.

   

   Você tem três opções para condições: Expressão Condicional, Filtro e Contagem de Ocorrências.

Você pode definir pontos de rastreamento especificando uma cadeia de caracteres de saída na caixa de seleção Ação na janela Configurações do Ponto de Interrupção.

1. Para inicializar um ponto de rastreamento, primeiro clique na sarjeta à esquerda do número de linha em que você deseja definir o ponto de rastreamento.

   

2. Passe o mouse sobre o círculo vermelho e clique no ícone de engrenagem para abrir a janela Configurações do Ponto de Interrupção.

   

3. Marque a caixa de seleção Ação.

   

   Observe como o círculo vermelho muda para um diamante indicando que você alternou de um ponto de interrupção para um ponto de rastreamento.

4. Insira a mensagem que você deseja fazer logon na caixa de texto Mostrar uma mensagem na Janela de Saída (para obter detalhes, consulte seções posteriores neste artigo).

   Agora, seu ponto de rastreamento está definido. Pressione o botão "Fechar" se tudo o que você deseja fazer é registrar algumas informações na Janela de Saída.

5. Se você quiser adicionar condições que determinem se sua mensagem é exibida, marque a caixa de seleção Condições.

   

   Você tem três opções para condições: Expressão Condicional, Filtro e Contagem de Ocorrências.

Esse menu permite registrar uma mensagem na janela Saída. Digite as cadeias de caracteres que você deseja gerar para a caixa de mensagem (sem aspas necessárias). Se você quiser exibir valores de variáveis, coloque-o entre chaves.

Por exemplo, se você quiser exibir o valor da variável counter no console de saída, digite {counter} na caixa de texto da mensagem.

Se você clicar em Fechar e depurar o programa (F5), verá a saída a seguir na janela Saída.

Você também pode usar palavras-chave especiais para exibir informações mais específicas. Insira a palavra-chave exatamente conforme mostrado abaixo (use um "$" na frente de cada palavra-chave e todas as tampas para a própria palavra-chave).

Esse menu permite registrar uma mensagem na janela Saída. Digite as cadeias de caracteres que você deseja gerar para a caixa de mensagem (sem aspas necessárias). Se você quiser exibir valores de variáveis, coloque-o entre chaves.

Por exemplo, se você quiser exibir o valor da variável counter no console de saída, digite {counter} na caixa de texto da mensagem.

Se você clicar em Fechar e depurar o programa (F5), verá a saída a seguir na janela Saída.

Você também pode usar palavras-chave especiais para exibir informações mais específicas. Insira a palavra-chave exatamente conforme mostrado abaixo (use um "$" na frente de cada palavra-chave e todas as tampas para a própria palavra-chave).

Para uma expressão condicional, uma mensagem de saída é exibida somente quando determinadas condições são atendidas.

Para expressões condicionais, você pode definir o ponto de rastreamento para gerar uma mensagem quando uma determinada condição for verdadeira ou quando ela for alterada. Por exemplo, se você quiser exibir apenas o valor do contador durante até mesmo iterações do loop for, poderá selecionar a opção É verdadeiro e digitar i%2 == 0 na caixa de texto da mensagem.

Se você quiser imprimir o valor do contador quando a iteração do for loop for alterada, selecione a opção Quando alterado e digite i na caixa de texto da mensagem.

O comportamento da opção Quando alterado é diferente para linguagens de programação diferentes.

• Para código nativo, o depurador não considera a primeira avaliação da condição como uma alteração, portanto, não atinge o tracepoint na primeira avaliação.
• Para código gerenciado, o depurador atinge o ponto de rastreamento na primeira avaliação depois que Quando alterado é selecionado.

Para obter uma visão mais abrangente das expressões válidas que você pode usar ao definir condições, consulte Expressões no depurador.

Para uma expressão condicional, uma mensagem de saída é exibida somente quando determinadas condições são atendidas.

Para expressões condicionais, você pode definir o ponto de rastreamento para gerar uma mensagem quando uma determinada condição for verdadeira ou quando ela for alterada. Por exemplo, se você quiser exibir apenas o valor do contador durante até mesmo iterações do loop for, poderá selecionar a opção É verdadeiro e digitar i%2 == 0 na caixa de texto da mensagem.

Se você quiser imprimir o valor do contador quando a iteração do for loop for alterada, selecione a opção Quando alterado e digite i na caixa de texto da mensagem.

O comportamento da opção Quando alterado é diferente para linguagens de programação diferentes.

• Para código nativo, o depurador não considera a primeira avaliação da condição como uma alteração, portanto, não atinge o tracepoint na primeira avaliação.
• Para código gerenciado, o depurador atinge o ponto de rastreamento na primeira avaliação depois que Quando alterado é selecionado.

Você também pode definir a condição quando o ponto de rastreamento pode ser habilitado inserindo um Ponto de Interrupção em qualquer seção específica do código e marcando a caixa de seleção Habilitar somente quando o seguinte ponto de interrupção for atingido: opção no menu Configurações do Ponto de Interrupção. Você pode escolher qualquer ponto de interrupção na lista de opções.

Para obter uma visão mais abrangente das expressões válidas que você pode usar ao definir condições, consulte Expressões no depurador.

Uma condição de contagem de ocorrências permite que você envie a saída somente depois que a linha de código em que o ponto de rastreamento está definido tiver executado um número especificado de vezes.

Para contagem de ocorrências, você pode optar por gerar uma mensagem quando a linha de código em que o ponto de rastreamento está definido tiver sido executada um determinado número de vezes. Com base no requisito, ele pode ser igual a ou é um múltiplo de ou é maior ou igual ao valor de contagem de ocorrências especificado. Escolha a opção que melhor atenda às suas necessidades e digite um valor inteiro no campo (por exemplo, 5) que representa essa iteração de interesse.

Uma condição de contagem de ocorrências permite que você envie a saída somente depois que a linha de código em que o ponto de rastreamento está definido tiver executado um número especificado de vezes.

Para contagem de ocorrências, você pode optar por gerar uma mensagem quando a linha de código em que o ponto de rastreamento está definido tiver sido executada um determinado número de vezes. Com base no requisito, ele pode ser igual a ou é um múltiplo de ou é maior ou igual ao valor de contagem de ocorrências especificado. Escolha a opção que melhor atenda às suas necessidades e digite um valor inteiro no campo (por exemplo, 5) que representa essa iteração de interesse.

Você também pode remover o ponto de interrupção na primeira ocorrência habilitando a caixa de seleção Remover ponto de interrupção após a ocorrência.

Para uma condição de filtro, especifique para quais dispositivos, processos ou saída de threads são mostrados.

Lista de expressões de filtro:

• MachineName = "nome"
• ProcessId = valor
• ProcessName = "nome"
• ThreadId = valor
• ThreadName = "nome"

Coloque cadeias de caracteres (como nomes) entre aspas duplas. Os valores podem ser inseridos sem aspas. Você pode combinar cláusulas usando & (AND), || (OR), ! (NOT) e parênteses.

Para uma condição de filtro, especifique para quais dispositivos, processos ou saída de threads são mostrados.

Lista de expressões de filtro:

• MachineName = "name"
• ProcessId = value
• ProcessName = "name"
• ThreadId = value
• ThreadName = "name"

Coloque cadeias de caracteres (como nomes) entre aspas duplas. Os valores podem ser inseridos sem aspas. Você pode combinar cláusulas usando & (AND), || (OR), ! (NOT) e parênteses.