Registrar informações na janela Saída usando pontos de rastreamento no Visual Studio

O programa de exemplo a seguir é um loop simples for com uma variável de contador que aumenta uma 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 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 é alterado 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).

   Seu ponto de rastreamento agora 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 que você registre uma mensagem na janela Saída. Digite as cadeias de caracteres que você deseja produzir na 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 counter variável 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 for loop, poderá selecionar a opção É verdadeiro e, em seguida, 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 When changed é diferente para diferentes linguagens de programação.

• 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 ponto de rastreamento na primeira avaliação.
• Para código gerenciado, o depurador atinge o ponto de rastreamento na primeira avaliação após 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 selecionando 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.

Obter assistência de IA

Se você tiver o Copilot, poderá obter assistência de IA enquanto estiver criando um ponto de rastreamento. O Copilot oferece sugestões de pontos de interrupção condicionais e pontos de rastreamento específicos ao seu código.

Para obter mais informações, consulte Depurar com Copilot.

Uma condição de contagem de ocorrências permite que você envie a saída somente após a linha de código em que o ponto de rastreamento está definido executou 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 número específico de vezes. Com base no requisito, ele pode ser igual a, ou é um múltiplo ou é maior ou igual ao valor de contagem de ocorrências especificado. Escolha a opção que melhor atende à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 no primeiro clique, habilitando a caixa de seleção Remover ponto de interrupção uma vez atingido.

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

Lista de expressões de filtro:

• MachineName = "nome"
• ProcessId = valor
• ProcessName = "name"
• 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.