NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Exceptions Dialog Box

The Exceptions dialog box enables you to change the way the debugger handles exceptions or categories of exceptions. From the Debug menu, choose Windows and choose Exceptions.

Exceptions
This box contains a number of tree controls. Each tree represents a category of exceptions, such as C Runtime Errors or NGWS Runtime Exceptions. If you expand a category, you will see the names of individual or subcategories of exceptions. You can choose on any exception or category to select it, then change it is handling using the buttons for When the exception is thrown and If the exception is handled. An icon next to each exception or category name indicates the current setting for When the exception is thrown.
When the exception is thrown
Choose a button from this group to change how the debugger handles the exception immediately after it is thrown and before the program you are debugging has a chance to handle it. The option chosen here effects the exception chosen in Exceptions box. If a category is chosen, the option chosen here effects all the exceptions in that category.
  • Break into debugger

    This option causes the debugger to break execution of your program and so that you can examine the situation and handle the exception yourself. When this option is selected, the icon next to the exception or category name looks like a large red ball with an "X" on it.

  • Continue

    This option allows execution to continue. When this option is selected, the icon next to the exception or category name looks like a large gray ball.

  • Use parent setting

    This option causes a specific exception to use the setting chosen for the parent node, which may be Break into debugger or Continue. When this option is selected, the icon next to the exception or category name looks like a small gray ball.

If the exception is not handled
Choose a button from this group to change how the debugger handles the exception on the second try, which is after the program you are debugging has tried to handle it and failed. The option chosen here affects the exception chosen in Exceptions box. If a category is chosen, the option chosen here affects all exceptions in that category
  • Break into debugger

    This option causes the debugger to break execution of your program and so that you can examine the situation and handle the exception yourself.

  • Continue

    This option allows execution to continue.

  • Use parent setting

    This option causes a specific exception to use the setting chosen for the parent node, which is Break into debugger or Continue.

Find
Choose this button to open a Find Exception dialog box, which you can use to search for an exception name in the Exceptions box. This saves you from having to open each individual tree to find the exception name you are looking for.
Find Next
Choose this button to find another exception with the same name, after you have found the first occurrence with the Find button.
Clear All
Choose this button to delete all user-added exceptions.
Add
Choose this button to add a new exception to a selected category.
Delete
Choose this button to delete a user-added exception.

See Also

Handling Exceptions | Debugging UI Reference