Como: Assista a uma expressão no depurador

This topic applies to:

Edition	Visual Basic	C#	F#	C++	Web Developer
Express
Pro, Premium e Ultimate

The Watch window and QuickWatch dialog box are places where you can enter variable names and expressions that you want to watch during a debugging session.

The QuickWatch dialog box enables you to examine a single variable or expression at a time. It is useful for taking a quick look at one value or a larger data structure. O Watch janela pode armazenar várias variáveis e expressões que você deseja exibir no decorrer da sessão de depuração. Some editions of Visual Studio have multiple Watch windows, which are numbered Watch1 through Watch4.

Para obter mais informações sobre como abrir o Watch ou QuickWatch windows, consulte To display a variable window.

A variable name is the simplest expression you can enter. If you are debugging native code, you can use register names as well as variable names. The debugger can accept much more complex expressions than that, however. For example, you could enter the following expression to find the average value of three variables:

(var1 + var2 + var3) / 3

No C#, você pode inserir uma identificação de objeto, ou o alias, em vez do nome do objeto.

O depurador aceita a expressões de linguagem mais válidas em um Watch janela. For more information, see Expressões no depurador.

If you are programming in native code, you may sometimes need to qualify the context of a variable name or an expression containing a variable name. The context means the function, source file, and module where a variable is located. Se você tiver que fazer isso, você pode usar a sintaxe do operador de contexto. For more information, see Operador de contexto (expressões de languagem C/C++).

Expressions that Affect the State of Your Program

Evaluating some expressions can change the value of a variable or otherwise affect the state of your program. Por exemplo, avaliar a expressão a seguir altera o valor de var1:

var1 = var2

Expressions that change data are said to have side effects. If you enter an expression that has a side effect into the Watch window, the side effect will occur every time the expression is evaluated by the Watch window. Isso pode produzir resultados inesperados se você não estiver ciente de que a expressão possui efeitos colaterais. Uma expressão que é conhecida por ter efeitos colaterais somente é avaliada uma vez, quando você primeiro digitá-lo. Subsequent evaluations are disabled. Manualmente, você pode substituir esse comportamento, clicando em um ícone de atualização que aparece ao lado do valor.

Freqüentemente, os efeitos colaterais inesperados são o resultado da avaliação da função. Por exemplo, você poderia inserir a seguinte chamada de função para o Watch janela:

Func1(var1)

If you call a function from the Watch window or QuickWatch, the function you are calling might change data, creating a side effect. Uma maneira de evitar possíveis efeitos colaterais inesperados provenientes de avaliação da função é desativar a avaliação automática de funções na Opções caixa de diálogo. Isso desativa a avaliação automática de novos recursos de idioma, como propriedades. No entanto, é mais seguro.

Observação
Quando você examinar an expression in a Watch janela, você poderá ver um ícone de atualização, o que se pareça com duas setas verdes, em direções opostas dentro de um círculo verde. Isso é especialmente provável se você tiver desativado a avaliação automática de funções. O ícone de atualização indica um erro ou valor desatualizado. For more information, see Como: Refresh Watch Values.

For native code and C#, you can specify a display format for the expression value using format specifiers. For more information, see Especificadores de formato em C++ and Especificadores de formato no C#.

The Visual Studio debugger automatically expands common data types to show their most important elements. You add expansions for custom data types. For more information, see Exibir os tipos de dados personalizados and Visualizadores.

Observação
Caixas de diálogo e comandos de menu que você vê podem diferir das descritas na Help dependendo das suas configurações ativas ou edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. For more information, see Trabalhando com configurações.

To evaluate an expression in the Watch window

1. In the Watch window, click an empty row in the Name column. The debugger must be in break mode at this point. Type or paste the variable name or expression you want to watch.

   —or—

   Drag a variable to a row in the Watch window.

2. Press ENTER.

   The result appears in the Value column. If you type the name of an array or object variable, a tree control appears next to the name in the Name column. Expand or collapse the variable in the Name column.

   The expression remains in the Watch window until you remove it.

To evaluate an expression in QuickWatch

1. In the QuickWatch dialog box, type or paste the variable, register, or expression into the Expression text box.

2. Clique em reavaliar ou pressione ENTER.

3. The value appears in the Current value box.

4. If you type the name of an array or object variable in the Expression box, a tree control appears next to the name in the Current value box. Expand or collapse the variable in the Name column.

To reevaluate a previous expression in QuickWatch

1. No QuickWatch caixa de diálogo, clique na seta para baixo que aparece à direita da expressão caixa.

2. Choose one of the previous expressions from the drop-down list.

3. Click Reevaluate.

Consulte também

Tarefas

Como: Use Debugger Variable Windows

Outros recursos

Variable Windows

Histórico de alterações

Date	History	Motivo
Dezembro de 2010	Adicionado um link para o procedimento que descreve como exibir o Watch e QuickWatch windows.	Comentários do cliente.