Inspect an exception using the Exception Helper

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

Dealing with exceptions is a common problem, no matter your technology or level of expertise. It can be a frustrating experience figuring out why exceptions are causing problems in your code. When you're debugging an exception in Visual Studio, we want to lessen that frustration by providing you with relevant exception information to help you debug your issue faster.

Exception Helper

Pause on the exception

When the debugger breaks on an exception, an exception error icon appears to the right of that line of code. A non-modal Exception helper will appear near the exception icon.

Exception helper next to a line of code

Inspect exception info

You can instantly read the exception type and exception message in the Exception Helper, and whether the exception was thrown or unhandled. You can inspect and view properties of the Exception object by clicking the View Details link.

Analyze null references

Starting in Visual Studio 2017, for both .Net and C/C++ code, when you hit a NullReferenceException or an AccessViolation, you see null analysis information in the Exception Helper. The analysis is displayed as text beneath the exception message. In the illustration below, the information is shown as "s was null.".

Exception helper null analysis

Note

Null reference analysis in managed code requires .NET version 4.6.2. Null analysis is currently not supported for Universal Windows Platform (UWP) and any other .NET Core applications. It is only available while debugging code that does not have any Just-In-Time (JIT) code optimizations.

Configure exception settings

You can configure the debugger to break when an exception of the current type is thrown from the Exception Settings section of the Exception Helper. If the debugger is paused at a thrown exception, then you can use the checkbox to disable breaking on that exception type when thrown in the future. If you don't want to break on this particular exception when thrown in this particular module, tick the checkbox by the module name under Except when thrown from: in the Exception Settings window.

Inspect inner exceptions

If the exception has any inner exceptions (InnerException, you can view them in the Exception Helper. If there are multiple exceptions present, you can navigate between them using the left and right arrows shown above the call stack.

Exception helper with inner exception

Inspect rethrown exceptions

In cases where an exception has been thrown the Exception Helper shows the call stack from the first time the exception was thrown. If the exception was thrown multiple times, only the call stack from the original exception is shown.

Exception helper with rethrown exceptions

Share a debug session with Live Share

From the Exception Helper, you can start a Live Share session using the link Start Live Share session.... Anyone who joins the Live Share session can see the Exception Helper along with any other debug information.