Export (0) Print
Expand All

Breakpoints.Add Method

Creates and enables a new breakpoint.

Namespace: EnvDTE
Assembly: EnvDTE (in envdte.dll)

Breakpoints^ Add (
	[InAttribute] [OptionalAttribute] String^ Function, 
	[InAttribute] [OptionalAttribute] String^ File, 
	[InAttribute] [OptionalAttribute] int Line, 
	[InAttribute] [OptionalAttribute] int Column, 
	[InAttribute] [OptionalAttribute] String^ Condition, 
	[InAttribute] [OptionalAttribute] dbgBreakpointConditionType ConditionType, 
	[InAttribute] [OptionalAttribute] String^ Language, 
	[InAttribute] [OptionalAttribute] String^ Data, 
	[InAttribute] [OptionalAttribute] int DataCount, 
	[InAttribute] [OptionalAttribute] String^ Address, 
	[InAttribute] [OptionalAttribute] int HitCount, 
	[InAttribute] [OptionalAttribute] dbgHitCountType HitCountType
)
Breakpoints Add (
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String Function, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String File, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ int Line, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ int Column, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String Condition, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ dbgBreakpointConditionType ConditionType, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String Language, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String Data, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ int DataCount, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String Address, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ int HitCount, 
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ dbgHitCountType HitCountType
)
function Add (
	Function : String, 
	File : String, 
	Line : int, 
	Column : int, 
	Condition : String, 
	ConditionType : dbgBreakpointConditionType, 
	Language : String, 
	Data : String, 
	DataCount : int, 
	Address : String, 
	HitCount : int, 
	HitCountType : dbgHitCountType
) : Breakpoints

Parameters

Function

Optional. A function breakpoint. The name of the function on which the breakpoint is set.

File

Optional. A file breakpoint. The name and optional path of the file in which the breakpoint is set.

Line

Optional. A file breakpoint. The source-code line number, measured from the start of the function, at which the breakpoint is set. If this value is 1, the breakpoint is set at the start of the function.

Column

Optional. A file breakpoint. The character at which the breakpoint is set. In most cases, you can leave this value set to 1, which sets the breakpoint at the start of the line.

Condition

Optional. The breakpoint Condition. Use with ConditionType.

ConditionType

Optional. The condition type. A dbgBreakpointConditionType value. Use with Condition.

Language

Optional. The programming language in which the function is written.

Data

Optional. A data breakpoint. If the breakpoint is set on a variable, you can specify the name of the variable. You can use the context operator to specify a variable outside the current scope.

DataCount

Optional. A data breakpoint. If the breakpoint is set on a variable, and if the variable is an array or dereferenced pointer, this value specifies the number of elements to watch.

Address

Optional. An address breakpoint. The memory address where the breakpoint is set, in decimal or hexadecimal format.

HitCount

Optional. The Hit Count property for the breakpoint. If you specify no hit count, program execution breaks each time the breakpoint is hit. If you specify a hit count, program execution breaks only on the specified number of hits.

HitCountType

Optional. The hit count type. A dbgHitCountType value.

Return Value

A Breakpoints collection.

Creates and enables a new breakpoint and returns a Breakpoints collection.

All parameters for this method are optional; however you can specify only one of four location types, as described below.

To set a breakpoint in this location type

Use parameter(s)

Within a function.

Function

Within a file. Can optionally specify the line and column location within the file.

File, Line, and Column

Within data. Can optionally be set for variables and the number of variables to watch.

Data and DataCount

At a specific address.

Address

To any of these location types, you can optionally supply Condition and ConditionType to break only when a specified condition is true. You can optionally supply HitCount and HitCountType to break on the specified hit count.

The following example demonstrates how to use the Add method.

To test this method:

  1. Open the target project and run the add-in.

No code example is currently available or this language may not be supported.

Community Additions

ADD
Show:
© 2014 Microsoft