View the call stack and use the Call Stack window in the debugger

  • Article

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

By using the Call Stack window, you can view the function or procedure calls that are currently on the stack. The Call Stack window shows the order in which methods and functions are getting called. The call stack is a good way to examine and understand the execution flow of an app.

When debugging symbols are not available for part of a call stack, the Call Stack window might not be able to display correct information for that part of the call stack, displaying instead:

[Frames below may be incorrect and/or missing, no symbols loaded for name.dll]

Note

The Call Stack window is similar to the Debug perspective in some IDEs like Eclipse.

Note

The dialog boxes and menu commands you see might differ from those described here, depending on your active settings or edition. To change your settings, select Import and Export Settings on the Tools menu. See Reset settings.

View the call stack while in the debugger

  • While debugging, in the Debug menu, select Windows > Call Stack.

    Call Stack Window

A yellow arrow identifies the stack frame where the execution pointer is currently located. By default, this stack frame's information appears in the source, Locals, Autos, Watch, and Disassembly windows. To change the debugger context to another frame on the stack, switch to another stack frame.

Display non-user code in the Call Stack window

  • Right-click the Call Stack window and select Show External Code.

Non-user code is any code that is not shown when Just My Code is enabled. In managed code, non-user code frames are hidden by default. The following notation appears in place of the non-user code frames:

[<External Code>]

Switch to another stack frame (change the debugger context)

  1. In the Call Stack window, right-click the stack frame whose code and data that you want to view.

    Or, you can double-click a frame in the Call Stack window to switch to that frame.

  2. Select Switch to Frame.

    A green arrow with a curly tail appears next to the stack frame you selected. The execution pointer remains in the original frame, which is still marked with the yellow arrow. If you select Step or Continue from the Debug menu, execution will continue in the original frame, not the frame you selected.

View the source code for a function on the call stack

  • In the Call Stack window, right-click the function whose source code you want to see and select Go To Source Code.

Run to a specific function from the Call Stack window

  • In the Call Stack window, select the function, right-click, and then choose Run to Cursor.

Set a breakpoint on the exit point of a function call

Display calls to or from another thread

  • Right-click the Call Stack window and select Include Calls To/From Other Threads.

Visually trace the call stack

In Visual Studio Enterprise (only), you can view code maps for the call stack while debugging.

Show Call Stack on Code Map

View the disassembly code for a function on the call stack (C#, C++, Visual Basic, F#)

  • In the Call Stack window, right-click the function whose disassembly code you want to see and select Go To Disassembly.

Change the optional information displayed

  • Right-click in the Call Stack window and set or clear Show <the information that you want>.

Load symbols for a module (C#, C++, Visual Basic, F#)

In the Call Stack window, you can load debugging symbols for code that does not currently have symbols loaded. These symbols can be .NET or system symbols downloaded from the Microsoft public symbol servers, or symbols in a symbol path on the computer that you are debugging.

See Specify symbol (.pdb) and source files.

To load symbols

  1. In the Call Stack window, right-click the stack frame for which symbols are not loaded. The frame will be dimmed.

  2. Point to Load Symbols and then select Microsoft Symbol Servers (if available), or browse to the symbol path.

To set the symbol path

  1. In the Call Stack window, choose Symbol Settings from the shortcut menu.

    The Options dialog box opens and the Symbols page is displayed.

  2. Select Symbol Settings.

  3. In the Options dialog box, click the Folder icon.

    In the Symbol file (.pdb) locations box, a cursor appears.

  4. Enter a directory pathname to the symbol location on the computer that you are debugging. For local and remote debugging, this is a path on your local computer.

  5. Select OK to close the Options dialog box.

See also