Janela Imediata

Artigo
06/19/2023

Use a janela Imediato para depurar e avaliar expressões, executar instruções e imprimir valores de variáveis. A janela Imediato avalia expressões compilando e usando o projeto atualmente selecionado.

Para exibir a janela Imediato, abra um projeto para edição, escolha Depurar>Windows>Imediato ou pressione Ctrl+Alt+I. Você também pode inserir Debug.Immediate na janela Comando.

A janela Imediato dá suporte ao IntelliSense.

Exibir os valores de variáveis

A janela Imediato é particularmente útil quando você está depurando um aplicativo. Por exemplo, para verificar o valor de uma variável varA, use o comando Imprimir:

>Debug.Print varA

O ponto de interrogação (?) é um alias para Debug.Print, portanto, esse comando também pode ser escrito:

? varA

As duas versões desse comando retornam o valor da variável varA.

Dica

Para emitir um comando do Visual Studio na janela Imediato, você precisa preceder o comando com um sinal de maior que (>). Para inserir vários comandos, alterne para a janela Comando.

Avaliação de expressão de tempo de design

Você pode usar a janela Imediato para executar uma função ou sub-rotina em tempo de design.

Executar uma função em tempo de design

Copie o seguinte código no aplicativo de console do Visual Basic:

Module Module1

    Sub Main()
        MyFunction(5)
    End Sub

    Function MyFunction(ByVal input as Integer) As Integer
        Return input * 2
    End Function

End Module

No menu Depuração, escolha Windows>Imediato.
Digite ?MyFunction(2) na janela Imediato e pressione Enter.

A janela Imediato executa MyFunction e exibe 4.

Se a função ou a sub-rotina contiverem um ponto de interrupção, o Visual Studio interromperá a execução no ponto apropriado. Então, você poderá usar o depurador do Windows para examinar o estado do programa. Para obter mais informações, consulte Passo a passo: depuração em tempo de design.

Não é possível usar a avaliação de expressão em tempo de design em tipos de projetos que exigem a inicialização de um ambiente de execução, incluindo projetos do Visual Studio Tools para Office, projetos Web, projetos de Dispositivo Inteligente e projetos do SQL.

Avaliação de expressão em tempo de design em soluções multiprojeto

Ao estabelecer o contexto para a avaliação de expressão em tempo de design, o Visual Studio referencia o projeto atualmente selecionado no Gerenciador de Soluções. Se nenhum projeto estiver selecionado no Gerenciador de Soluções, o Visual Studio tentará avaliar a função com relação ao projeto de inicialização. Se a função não puder ser avaliada no contexto atual, você receberá uma mensagem de erro. Se você estiver tentando avaliar uma função em um projeto que não é o projeto de inicialização da solução e receber um erro, tente selecionar o projeto no Gerenciador de Soluções e tente fazer a avaliação novamente.

Inserir comandos

Insira o sinal de maior que (>) ao emitir comandos do Visual Studio na janela Imediato. Use as teclas Seta para cima e Seta para baixo para rolar pelos comandos usados anteriormente.

Tarefa	Solução	Exemplo
Avaliar uma expressão.	Preceda a expressão com um ponto de interrogação (?).	`? a+b`
Entrar temporariamente no modo Comando enquanto está no modo Imediato (para executar um único comando).	Digite o comando precedendo-o com um sinal de maior que (>).	`>alias`
Mude para a janela Comando.	Insira `cmd` na janela, precedendo-o com um sinal de maior que (>).	`>cmd`
Mude para a janela Imediato.	Insira `immed` na janela, sem o sinal de maior que (>).	`immed`

Modo de marca

Quando clica em qualquer linha anterior na janela Imediato, você muda automaticamente para o modo de Marca. Isso permite selecionar, editar e copiar o texto de comandos anteriores como você faria em qualquer editor de texto e colá-lo na linha atual.

Exemplos

O exemplo a seguir mostra quatro expressões e seus resultados na janela Imediato para um projeto do Visual Basic.

j = 2
Expression has been evaluated and has no value

? j
2

j = DateTime.Now.Day
Expression has been evaluated and has no value

? j
26

Notificações de exceção de primeira tentativa

Em algumas configurações, notificações de exceção de primeira tentativa são exibidas na janela Imediato.

Ativar ou desativar notificações de exceção de primeira tentativa na janela Imediato

No menu Exibir, clique em Outras Janelas e clique em Saída.
Clique com o botão direito do mouse na área de texto da Janela de Saída e marque ou desmarque Mensagens de Exceção.

Partilhar via