Partilhar via


Use a janela Imediata

Este artigo explica como usar a janela Immediate para depurar e avaliar expressões, executar instruções e imprimir valores de variáveis. A janela Immediate avalia expressões construindo e usando o projeto selecionado no momento.

Para exibir a janela Immediate , primeiro abra um projeto para editar e, em seguida, escolha Depurar>Windows>Immediate ou pressione Ctrl+Alt+I. Você também pode inserir Debug.Immediate na janela de comando .

A janela Immediate suporta IntelliSense.

Exibir os valores das variáveis

A janela Immediate é útil quando você depura 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 deste comando retornam o valor da variável varA.

Sugestão

Para emitir um comando do Visual Studio na janela Immediate , você deve prefaciar 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 Immediate 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 Immediate e pressione Enter.

    A janela Immediate é executadaMyFunction e exibe 4.

Se a função ou 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: Depurar 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 Visual Studio Tools for Office projetos, projetos Web, projetos Smart Device e projetos SQL.

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

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 para a solução e receber um erro, tente selecionar o projeto no Gerenciador de Soluções e tente a avaliação novamente.

Inserir comandos

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

Tarefa Solução Exemplo
Avalie uma expressão. Prefacie a expressão com um ponto de interrogação (?). ? a+b
Entre temporariamente no modo de comando enquanto estiver no modo imediato (para executar um único comando). Digite o comando, prefaciando-o com um sinal maior que (>). >alias
Alterne para a janela de comando. Entre cmd na janela, prefaciando-a com um sinal maior que (>). >cmd
Volte para a janela Immediate. Entre immed na janela sem o sinal maior que (>). immed

Modo de marcação

Ao selecionar qualquer linha anterior na janela Immediate , você muda automaticamente para o modo Marcar. Isso permite que você selecione, edite e copie o texto de 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 Immediate para um projeto 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 oportunidade

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

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

  1. No menu Ver, selecione 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.