Exibir threads e tarefas na janela Pilhas Paralelas (C#, Visual Basic, C++)

A janela Pilhas Paralelas é útil quando você está depurando aplicativos multithreaded. Existem várias visões:

• Exibição de threads mostra informações de pilha de chamadas para todos os threads no aplicativo. Você pode navegar entre threads e registros de ativação nessas threads.

• Exibição tarefas mostra as informações da pilha de chamadas centralizada por tarefas.

  • No código gerenciado, a exibição Tarefas mostra pilhas de chamadas de objetos System.Threading.Tasks.Task.
  • No código nativo, a exibição de Tarefas mostra pilhas de chamadas de grupos de tarefas , algoritmos paralelos , agentes assíncronos e tarefas leves .

• Exibição de Método dinamiza a pilha de chamadas em um método selecionado.

Usar a janela Pilhas Paralelas

Para abrir a janela Pilhas Paralelas, você deve estar em uma sessão de depuração. Selecione Depurar>Janelas>Pilhas Paralelas.

Controles da barra de ferramentas

A janela Pilhas Paralelas tem os seguintes controles de barra de ferramentas:

Ícone	Controle	Descrição
	Caixa de combinação Threads/Tarefas	Alterna a exibição entre pilhas de chamadas de threads e pilhas de chamadas de tarefas. Para obter mais informações, confira Exibição de tarefas e Exibição de threads.
Ícone de filtro	Filtrar Controle	Mostra pilhas de chamadas somente para o conjunto específico de threads em que você está interessado.
	Mostrar somente sinalizados	Mostra pilhas de chamadas apenas para os threads sinalizados em outras janelas de depuração, como a janela Threads da GPU e a janela Inspeção Paralela.
	Ativar/Desativar a Exibição de Método	Alterna entre exibições de pilha de chamadas e Exibição de Método. Para obter mais informações, confira Exibição do Método.
	Rolagem Automática para o Registro de Ativação Atual	Rola automaticamente o grafo de forma que o registro de ativação atual esteja em exibição. Este recurso é útil quando você modifica o registro de ativação atual de outras janelas ou quando você atinge um novo ponto de interrupção em grandes grafos.
	Ativar/Desativar o Controle de Zoom	Mostrar ou ocultar o controle de zoom à esquerda da janela. Independentemente da visibilidade do controle de zoom, você também pode ampliar pressionando Ctrl e girando a roda do mouse, ou pressionando Ctrl +Shift++ para aumentar e Ctrl +Shift+- para reduzir.
ícone de pesquisa	Controle de Pesquisa	Com esse recurso, você pode pesquisar facilmente por meio de registros de ativação e, em seguida, usar setas para navegar entre esses resultados.
ícone salvar	Salvar Controle	Permite salvar/exportar o conteúdo da janela de pilha paralela como uma imagem.
	Mostrar o Controle de Código Externo	Com este recurso, você pode mostrar/ocultar as pilhas do código/bibliotecas externas.
	Resumir pilhas de chamadas	A partir do Visual Studio 2022 versão 17.13 Preview 4, você pode escolher Summarize quando o Copilot estiver instalado e ativado. Esse botão abre a janela do Copilot Chat, pré-carregada com o contexto relevante do thread, permitindo que você explore detalhes, incluindo estados do thread, chamadas de função e correções sugeridas.

Ícones de Registro de Ativação

Os ícones a seguir fornecem informações sobre os registros de ativação ativos e atuais em todos os modos de exibição:

Ícone	Descrição
	Indica o local atual (registro de ativação ativo) do thread atual.
ícone	Indica o local atual (registro de ativação ativo) de um thread não atual.
	Indica o registro de ativação atual (o contexto atual do depurador). O nome do método fica em negrito onde quer que apareça.
Erro de Status	Indica que o registro de ativação atual tem um aviso de status crítico, como Deadlock.
status de	Indica o nó com deadlock.
	Indica que o registro de ativação atual tem informações adicionais, como Aguardando, Aguardando o bloqueio, Propriedade de etc.
	Indica que a tarefa atual está no estado bloqueado/esperando, etc.
	Indica a tarefa em execução no momento.

Itens do menu de contexto

Os itens do menu de atalho a seguir ficam disponíveis quando você clica com o botão direito do mouse em um método na exibição Threads ou Tarefas. Os últimos seis itens são os mesmos da janela Pilha de Chamadas.

Item de menu	Descrição
Copiar	Copiar o item selecionado.
Selecionar todos os quadros abaixo	Seleciona todos os quadros sob a pilha selecionada.
Sinalizar	Marca o item selecionado.
Remover Sinalização	Desmarca o item selecionado.
Congelar	Congela o item selecionado.
Descongelar	Descongela o item selecionado.
Alternar para Quadro	O mesmo que o comando do menu correspondente na janela Pilha de Chamadas. No entanto, na janela Pilhas Paralelas, um método pode estar em vários quadros. Você pode selecionar o quadro desejado no submenu desse item. Se um dos registros de ativação estiver no thread atual, esse registro será selecionado por padrão no submenu.
Ir para Tarefa ou Ir para Tópico	Alterna para a exibição Tarefa ou Threads e mantém o mesmo registro de ativação realçado.
Ir para o Código-Fonte	Vai para o local correspondente na janela do código-fonte.
Ir para Desmontagem	Vai para o local correspondente na janela do Desmontagem.
Mostrar Código Externo	Mostrar ou ocultar o código externo.
Exibição Hexadecimal	Alternar entre exibição decimal e hexadecimal.
Mostrar Conversas na Origem	Sinaliza o local do thread na janela de código-fonte.
Informações de Carregamento de Símbolos	Abre a caixa de diálogo Informações de Carga do Símbolo.
Configurações de Símbolo	Abre a caixa de diálogo Configurações do Símbolo.

Exibição de threads

Na exibição Threads, o registro de ativação e o caminho de chamada do thread atual são realçados em azul. A localização atual do thread é mostrada pela seta amarela.

Para alterar o registro de ativação atual, clique duas vezes em um método diferente. Isso também pode alternar o thread atual, dependendo se o método selecionado faz parte do thread atual ou de outro thread.

Quando a exibição Threads é muito grande para caber na janela, um controle de Vista Panorâmica aparece na janela. Você pode mover o quadro no controle para navegar até diferentes partes do gráfico.

A ilustração a seguir mostra o thread principal em uma transição de código gerenciado para nativo. Cinco threads estão no método atual. Quatro threads continuam em execução no contexto do método S.C, enquanto um thread de trabalho continua em uma transição de código gerenciado para nativo, definindo o nome em um thread de trabalho.

A tabela a seguir descreve os principais recursos da exibição Threads:

Texto Explicativo	Nome do elemento	Descrição
1	Segmento ou nó da pilha de chamadas	Contém uma série de métodos para um ou mais threads. Se o quadro não tiver linhas de seta conectadas a ele, o quadro mostrará o caminho inteiro de chamada para os threads.
2	Realce azul	Indica o caminho da chamada do thread atual.
3	Linhas de seta	Conecte os nós para compor o caminho inteiro de chamada para os threads.
4	Cabeçalho do nó	Mostra o número de processos/threads, o nome do thread e a ID do thread para o nó.
5	Método	Representa um ou mais registros de ativação no mesmo método.
6	Dica de ferramenta sobre o método	Aparece quando você focaliza um método. Na exibição Threads, a dica de ferramenta mostra todos os threads, em uma tabela semelhante à janela Threads.
7	Descrição do thread	Descrição gerada por IA do thread. A partir do Visual Studio 2022 versão 17.13 Versão Prévia 1, essa descrição está presente quando o Copilot está instalado e ativado.

Exibição de tarefas

Se seu aplicativo usar objetos System.Threading.Tasks.Task (código gerenciado) ou objetos task_handle (código nativo) para expressar paralelismo, você pode usar a exibição Tarefas. A exibição de Tarefas mostra as pilhas de chamadas de tarefas reais em vez de threads.

Na exibição Tarefas:

• As pilhas de chamadas de threads que não estão executando tarefas não são mostradas.
• As pilhas de chamadas de threads que estão executando tarefas serão cortadas visualmente na parte superior e inferior para mostrar os quadros mais relevantes que pertencem a tarefas.
• Quando várias tarefas estiverem em um thread, as pilhas de chamadas dessas tarefas serão divididas em nós separados.

Para ver uma pilha de chamadas inteira, volte para a exibição Threads clicando com o botão direito do mouse em um registro de ativação e selecionando Ir paro thread.

A ilustração a seguir mostra a exibição Threads na parte superior e a exibição Tarefas correspondente na parte inferior.

Focalize um método para mostrar uma dica de ferramenta com informações adicionais. Na exibição Tarefas, a dica de ferramenta mostra todas as tarefas em uma tabela semelhante à janela Tarefas.

A imagem a seguir mostra a dica de ferramenta de um método na exibição Threads na parte superior e para a exibição Tarefas correspondente na parte inferior.

Visão do Método

Da exibição Threads ou Tarefas, você pode girar o grafo no método atual selecionando o ícone Alternar Exibição do Método na barra de ferramentas. A Exibição do Método mostra rapidamente todos os métodos em todos os threads que chamam ou são chamados pelo método atual. A ilustração a seguir mostra a aparência das mesmas informações na exibição Threads à esquerda e na exibição de Método à direita.

Se você alternar para um novo registro de ativação, você tornará esse o método atual e a exibição Método mostrará todos os chamadores e chamados para o novo método. Isso pode fazer com que alguns threads apareçam ou desapareçam da exibição, dependendo se esse método aparece em suas pilhas de chamadas. Para retornar à exibição de pilha de chamadas, selecione o ícone da barra de ferramentas de exibição de Método novamente.

Tutorial em vídeo sobre como depurar threads e tarefas com pilhas paralelas

Estes tutoriais em vídeo demonstram como você pode usar as exibições Threads e Tarefas da janela Pilhas Paralelas no Visual Studio 2022 para depurar seus aplicativos em vários threads.

• Tarefas de depuração com a janela Pilhas Paralelas
• Threads de depuração com a janela Pilhas Paralelas

Conteúdo relacionado

• Introdução à depuração de um aplicativo multithread
• Passo a passo: depurar um aplicativo paralelo
• Alternar para outro thread durante a depuração no Visual Studio
• Depurando código gerenciado
• Programação paralela
• Utilize a janela de Tarefas
• Classe da Tarefa