Breakpoint Dialog Box: Exception
See Also
You use this dialog box to set the properties of an exception breakpoint.
You can set exception breakpoint properties when you set a new breakpoint or when modifying an
existing breakpoint.
- To set a new exception breakpoint, choose Run > New Breakpoint
(Ctrl-Shift-F8) from the main menu, then select Exception from the Breakpoint Type drop-down list.
- To customize an existing exception breakpoint, right-click the exception breakpoint in the
Breakpoints window and choose Customize.
You can set the following values:
- Settings
- Exception Class Name. The full class name of the exception or error.
- Stop on. Specifies when to trigger the breakpoint.
The breakpoint can be triggered when the exception is caught, when the exception is not caught, or on all
exceptions (exception caught or uncaught).
- Conditions
- Filter on Classes Throwing the Exception. When selected, you can filter the classes that trigger the breakpoint.
You can specify that only exceptions occuring in classes matching a specific class name can trigger the breakpoint.
You can also specify that exceptions occuring in specified classes do not trigger the breakpoint.
- Condition. A Boolean expression that triggers the breakpoint when the expression evaluates to True. For information on the syntax rules for setting a condition, see Syntax Rules for Setting a Condition on a Breakpoint.
- Break when hit count. When selected, enables you to specify how frequently the breakpoint is triggered.
Choose a criteria in the drop-down list and then specify a numerical value.
- Actions
- Suspend. Specifies which threads in the program
being debugged are suspended when the breakpoint is reached.
You can specify no threads, all threads, or the breakpoint
thread. The breakpoint thread is the thread that is current
when the breakpoint is reached.
- Print Text. The specified message is printed in the
Debugger Console view of the Output window.
For information on the tags you can include in the message, see Printing a Breakpoint Message.
- See Also
- New Breakpoint Dialog Box
- Setting a Java Breakpoint
- Breakpoints in the IDE
Legal Notices