Registrar informações na janela Saída usando tracepoints no Visual Studio

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

1. Para inicializar um tracepoint, clique primeiro na calha à esquerda do número da linha onde você deseja definir o tracepoint.

   

2. Passe o cursor 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ê mudou de um ponto de interrupção para um ponto de rastreamento.

4. Introduza a mensagem em que pretende iniciar sessão na caixa de texto Mostrar uma mensagem na Janela de Saída (para obter detalhes, consulte as secções posteriores deste 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 desejar adicionar condições que determinem se sua mensagem será 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 acertos.

Este menu permite que você registre uma mensagem na janela Saída. Digite as cadeias de caracteres que você deseja enviar para a caixa de mensagem (sem aspas necessárias). Se você quiser exibir valores de variáveis, certifique-se de colocá-lo em chaves encaracoladas.

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

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

Você também pode usar palavras-chave especiais para exibir informações mais específicas. Digite a palavra-chave exatamente como mostrado abaixo (use um "$" na frente de cada palavra-chave e todas as letras maiúsculas para a palavra-chave em si).

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 tracepoint 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 as iterações pares do loop, você pode selecionar a opção for e, em seguida, digite a caixa de i%2 == 0 texto da mensagem.

Se desejar imprimir o valor do contador quando a iteração do loop for alterada, selecione a opção for e digite a caixa de i texto da mensagem.

O comportamento da opção Quando alterado é 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 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 Ativar 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.

Obtenha assistência de IA

Se você tiver o Copilot, poderá obter assistência de IA enquanto cria um ponto de rastreamento. O Copilot oferece sugestões para pontos de interrupção condicionais e pontos de rastreamento específicos para 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 depois que a linha de código onde o tracepoint está definido tiver sido executada um número especificado de vezes.

Para contagem de acertos, você pode optar por gerar uma mensagem quando a linha de código onde o tracepoint 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 acertos especificado. Escolha a opção que melhor se adapta à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 acerto ativando 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 = "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.