Compartilhar via


Usar a janela Imediata

Use a janela Imediata para depurar e avaliar expressões, executar instruções e imprimir valores variáveis. A janela Imediata avalia expressões criando e usando o projeto selecionado no momento.

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

A janela Imediata dá suporte ao IntelliSense.

Exibir os valores das variáveis

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

>Debug.Print varA

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

? varA

Ambas as versões desse comando retornam o valor da variável varA.

Dica

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

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

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

Executar uma função em tempo de design

  1. Copie o seguinte código em um 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
    
  2. No menu Depurar , escolha Windows>Immediate.

  3. Digite ?MyFunction(2) na janela Imediato e pressione Enter.

    A janela Imediata é executada MyFunction e exibida 4.

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

Você não pode usar a avaliação de expressão em tempo de design em tipos de projeto que exigem a inicialização de um ambiente de execução, incluindo as Ferramentas do Visual Studio para projetos do Office, projetos Web, projetos de Dispositivo Inteligente e projetos SQL.

Avaliação de expressão em tempo de design em soluções de vários projetos

Ao estabelecer o contexto para avaliação de expressão em tempo de design, o Visual Studio faz referência ao projeto atualmente selecionado no Gerenciador de Soluções. Se nenhum projeto for selecionado no Gerenciador de Soluções, o Visual Studio tentará avaliar a função em 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 a avaliação novamente.

Inserir comandos

Insira o sinal maior que (>) ao emitir comandos do Visual Studio na janela Imediata . Use as teclas seta para cima e seta para baixo para percorrer os comandos usados anteriormente.

Tarefa Solução Exemplo
Avaliar uma expressão. Preceda a expressão com um ponto de interrogação (?). ? a+b
Insira temporariamente o modo Comando no modo Imediato (para executar um único comando). Insira o comando, pré-fabricado com um sinal maior que (>). >alias
Alterne para a janela Comando. Insira cmd na janela, pré-fabricado com um sinal maior que (>). >cmd
Volte para a janela Imediata. Insira immed na janela sem o sinal maior que (>). immed

Modo de marcação

Ao clicar em qualquer linha anterior na janela Imediata , você muda automaticamente para o modo Mark. Isso permite que você selecione, edite e copie o texto dos comandos anteriores como faria em qualquer editor de texto e cole-os na linha atual.

Exemplos

O exemplo a seguir mostra quatro expressões e seu resultado na janela Imediata 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 chance

Em algumas configurações, as notificações de exceção de primeira chance são exibidas na janela Imediata .

Alternar notificações de exceção de primeira chance na janela Imediata

  1. No menu Exibir , clique em Outras Janelas e clique em Saída.

  2. Clique com o botão direito do mouse na área de texto da janela Saída e selecione ou desmarque Mensagens de Exceção.

Consulte também