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!

Using the Breakpoints Window

The Breakpoints Window lists all breakpoints currently set in your program and displays their properties. In the Breakpoints window, you can set (create) new breakpoints, delete breakpoints, enable or disable breakpoints, edit a breakpoint's properties, or find the source or disassembly code corresponding to a breakpoint.

To display the Breakpoints window

The Breakpoints window occupies the same frame as the Autos, Locals, and This windows. Tabs at the bottom of the frame allow you to switch from one window to another. The titlebar of the window reflects the current tab.

Viewing Breakpoint Information

The Breakpoints window contains a list of all breakpoints currently set in your program. This list contains three columns of information by default. You can view additional information by adding more columns.

To display additional columns

To hide a column

Hierarchical Breakpoints

A tree control may appear in the Name column next to certain breakpoints. These are hierarchical breakpoints, which are created when you set a breakpoint request that may spawn additional breakpoints. For example, you might set a breakpoint on a class that gets instantiated four or five times. Each time an object of that class gets created, a new breakpoint instance is created along with it.

Enabling/Disabling Breakpoints

A checkbox appears in the Name column next to each breakpoint. The state of this checkbox tells you whether the breakpoint is enabled or disabled.

To enable or disable a single breakpoint

To enable or disable a hierarchical breakpoint and its children

Setting, Deleting, and Editing Breakpoints

To set a new breakpoint

  1. In the toolbar at the top of the Breakpoints window, choose the New Breakpoint icon.
  2. In the New Breakpoint Dialog Box, choose the type of breakpoint and the options you want.
  3. Click OK.

To delete a breakpoint

  1. In the Breakpoints window, click on the breakpoint you want to delete.
  2. In the toolbar at the top of the window, choose the Delete tool.

To edit a breakpoint

  1. In the Breakpoints window, click on the breakpoint you want to edit.
  2. In the toolbar at the top of the window, choose the Properties tool.
  3. In the Breakpoint Properties dialog box, choose the type of breakpoint and the options you want.
  4. Click OK.

Viewing The Location Of a Breakpoint

For breakpoints that are set on a location, you can view the breakpoint location in the source file or disassembly code. (A breakpoint set on a variable, called a data breakpoint, has no such location.)

To view the location of a breakpoint in the source code

  1. In the Breakpoints window, click on the breakpoint you want to view.
  2. In the toolbar at the top of the window, choose the Go To Source Code tool.

To view the location of a breakpoint in the disassembly code

  1. In the Breakpoints window, click on the breakpoint you want to view.
  2. In the toolbar at the top of the window, choose the Go To Disassembly tool.

If you select a data breakpoint in the Breakpoints window, the Go To Source Code and Go To Disassembly tools are disabled.

See Also

Breakpoints