This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!
Breakpoints Window
To open the Breakpoints window, from the Debug menu, choose Windows, and then choose Breakpoints.
To save screen space, the Breakpoints window shares the same frame as the Autos, Locals, This, and Disassembly windows. You can switch back and forth between these windows using the tabs at the bottom of the frame. The title bar changes accordingly.
The Breakpoints window contains a toolbar and a list of breakpoints currently set in your program. The toolbar contains the following tools:
- New (Breakpoint)
- Opens a dialog box that gives you complete options for creating a new breakpoint.
- Delete
- Removes whatever breakpoint is currently selected. You cannot undo this operation.
- Go to Source Code
- Opens a source window, if necessary, and shows you the location where the breakpoint is set.
- Go to Disassembly
- Shows the Disassembly window and the location where the breakpoint is set.
- Columns
- Selects the informational columns that appear in the breakpoint list.
- Properties
- Opens a dialog box that allows you to edit any breakpoint property.
The list contains three columns of information by default:
- Name
- A descriptive name for the breakpoint, created by the debugger based on the breakpoint's location or other properties. The Name allows you to distinguish between breakpoints and select the one you are interested in.
A check box appears before the name. You can use this check box to enable or disable the breakpoint.
- Condition
- An optional property that determines whether your program breaks when the breakpoint is reached. The condition can be any valid expression recognized by the debugger. The debugger evaluates the condition and breaks execution only if the condition is satisfied
- Hit Count
- Another optional property that determines whether your program breaks when the breakpoint is reached. If this property is not set, the debugger stops each time the breakpoint is hit, assuming that the expression shown in Condition column is satisfied. The hit count can notify the debugger to break on the Nth time the breakpoint is reached, or on every multiple of N hits, or on the Nth hit and every time thereafter.
The following columns are not shown by default, but you can add them using the Columns tool:
- Language
- For a breakpoint set on a variable, which is a data breakpoint), the language in which the debugger evaluates the variable.
- Function
- The name of the function where the breakpoint is set and the location within the function.
- File
- The name of the file where the breakpoint is set and the location within the function.
- Address
- The memory address where the breakpoint is set.
- Data
- For a breakpoint set on a variable, which is a data breakpoint, the name of the variable.
- Program
- The name of the program in which the breakpoint is set.
See Also
Breakpoints | Debugging UI Reference