Debugger5 Interface
Debugger5 is used to interrogate and manipulate the state of the debugger and the program being debugged. Debugger5 supersedes the Debugger4 interface.
Namespace: EnvDTE100
Assembly: EnvDTE100 (in EnvDTE100.dll)
Syntax
'Declaration
<GuidAttribute("C8BBAA3A-7E99-4630-942C-570F085141EB")> _
Public Interface Debugger5 _
Inherits Debugger4
[GuidAttribute("C8BBAA3A-7E99-4630-942C-570F085141EB")]
public interface Debugger5 : Debugger4
[GuidAttribute(L"C8BBAA3A-7E99-4630-942C-570F085141EB")]
public interface class Debugger5 : Debugger4
[<GuidAttribute("C8BBAA3A-7E99-4630-942C-570F085141EB")>]
type Debugger5 =
interface
interface Debugger4
end
public interface Debugger5 extends Debugger4
The Debugger5 type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
AllBreakpointsLastHit | (Inherited from Debugger4.) |
|
AllBreakpointsLastHit | Gets a collection of bound breakpoints that were last simultaneously hit. |
|
BreakpointLastHit | (Inherited from Debugger4.) |
|
BreakpointLastHit | Gets the last breakpoint hit. To get a collection of multiple breakpoints hit simultaneously, see AllBreakpointsLastHit. |
|
Breakpoints | (Inherited from Debugger4.) |
|
Breakpoints | Gets a collection of breakpoints. |
|
CurrentMode | (Inherited from Debugger4.) |
|
CurrentMode | Gets the current mode of the debugger within the context of the IDE. |
|
CurrentProcess | (Inherited from Debugger4.) |
|
CurrentProcess | Gets or sets the active process. |
|
CurrentProgram | (Inherited from Debugger4.) |
|
CurrentProgram | Sets or returns the active program. |
|
CurrentStackFrame | (Inherited from Debugger4.) |
|
CurrentStackFrame | Gets or sets the current stack frame. |
|
CurrentThread | (Inherited from Debugger4.) |
|
CurrentThread | Gets or sets the current thread being debugged. |
|
DebuggedProcesses | (Inherited from Debugger4.) |
|
DebuggedProcesses | Gets the list of processes that are currently being debugged. |
|
DTE | (Inherited from Debugger4.) |
|
DTE | Gets the top-level extensibility object. |
|
ExceptionGroups | (Inherited from Debugger4.) |
|
ExceptionGroups | Gets the exception settings for the debugger. For each exception, these settings determine whether the debugger gives the code a chance to handle the exception before the debugger breaks execution. |
|
ForceContinue | (Inherited from Debugger4.) |
|
ForceContinue | Gets or sets a value that determines whether the debugger breaks or continues when a tracepoint or breakpoint finishes executing a macro. The default behavior is set by the user in the dialog box when the tracepoint or breakpoint is created. This property can be used to change the default behavior. |
|
HexDisplayMode | (Inherited from Debugger4.) |
|
HexDisplayMode | Gets or sets a value that indicates whether the expressions are output in hexadecimal or decimal format. |
|
HexInputMode | (Inherited from Debugger4.) |
|
HexInputMode | Gets or sets a value that indicates whether the expressions are evaluated in hexadecimal or decimal format. |
|
Languages | (Inherited from Debugger4.) |
|
Languages | Gets a list of languages that the debugger supports. |
|
LastBreakReason | (Inherited from Debugger4.) |
|
LastBreakReason | Gets the last reason that a program was broken. If the program is running, it returns DBG_REASON_NONE. |
|
LocalProcesses | (Inherited from Debugger4.) |
|
LocalProcesses | Gets the list of processes that are currently running on this computer. |
|
OnlyLoadSymbolsManually | (Inherited from Debugger4.) |
|
OnlyLoadSymbolsManually | Gets a value that determines whether symbols are loaded manually or automatically. The Visual Studio user can determine this setting in the Options dialog box. For more information about how to set this value within Visual Studio, see How to: Specify Symbol Locations and Loading Behavior. |
|
Parent | (Inherited from Debugger4.) |
|
Parent | Gets the immediate parent object (DTE). |
|
SymbolCachePath | (Inherited from Debugger4.) |
|
SymbolCachePath | Gets a string that contains the path to the symbols cache used by Visual Studio when you download symbols from a symbols server. You can specify the symbols cache path in the Options dialog box. For more information, see How to: Use a Symbol Server. |
|
SymbolPath | (Inherited from Debugger4.) |
|
SymbolPath | Gets a string that contains paths to .PDB symbol files that are used by Visual Studio for debugging. The Visual Studio user can specify symbols paths in the Options dialog box. For more information, see How to: Specify Symbol Locations and Loading Behavior. |
|
SymbolPathState | (Inherited from Debugger4.) |
|
SymbolPathState | Gets a string that represents the state of all symbol paths for the .PDB symbol files that are used by Visual Studio for debugging. |
|
Transports | (Inherited from Debugger4.) |
|
Transports | Gets a collection of supported debugging transports. |
Top
Methods
| Name | Description | |
|---|---|---|
.gif "Public method") |
Break(Boolean) | (Inherited from Debugger4.) |
|
Break(Boolean) | Causes the given process to pause its execution so that its current state can be analyzed. |
|
DeleteObjectID | Deletes the object ID. |
|
DetachAll() | (Inherited from Debugger4.) |
|
DetachAll() | Detaches from all attached programs. |
|
ExecuteStatement(String, Int32, Boolean) | (Inherited from Debugger4.) |
|
ExecuteStatement(String, Int32, Boolean) | Executes the specified statement. If the TreatAsExpression flag is true, then the string is interpreted as an expression, and output is sent to the Command Window. |
|
ExportBreakpoints | Exports the breakpoints to a file. |
|
GetExpression(String, Boolean, Int32) | (Inherited from Debugger4.) |
|
GetExpression(String, Boolean, Int32) | Evaluates an expression based on the current stack frame. If the expression can be parsed but not evaluated, an object is returned but does not contain a valid value. |
|
GetExpression2(String, Boolean, Boolean, Int32) | (Inherited from Debugger4.) |
|
GetExpression2(String, Boolean, Boolean, Int32) | Evaluates an expression based on the current stack frame. If the expression can be parsed but not evaluated, an object is returned but does not contain a valid value. This method is similar to GetExpression but with an additional Boolean parameter, which can be set to true to indicate that the expression is to be evaluated as a statement. |
|
GetExpression3(String, StackFrame, Boolean, Boolean, Boolean, Int32) | (Inherited from Debugger4.) |
|
GetExpression3(String, StackFrame, Boolean, Boolean, Boolean, Int32) | Evaluates an expression, similar to GetExpression(String, Boolean, Boolean, Int32). However, this method allows the caller to specify the stack frame that the evaluation will occur on. It also allows the caller to specify whether automatic evaluation of properties and implicit function calls should occur. |
|
GetProcesses(Transport, String) | (Inherited from Debugger4.) |
|
GetProcesses(Transport, String) | Gets an object that represents the processes that are currently connected for debugging on the specified transport. |
|
Go(Boolean) | (Inherited from Debugger4.) |
|
Go(Boolean) | Starts executing the program from the current statement. |
|
ImportBreakpoints | Imports breakpoints from a file. |
|
RunToCursor(Boolean) | (Inherited from Debugger4.) |
|
RunToCursor(Boolean) | Executes the program to the current position of the source file cursor. |
|
SetNextStatement() | (Inherited from Debugger4.) |
|
SetNextStatement() | Sets the next instruction to be executed, according to the cursor position in the current source file. |
|
SetSymbolSettings(String, String, String, Boolean, Boolean) | (Inherited from Debugger4.) |
|
SetSymbolSettings(String, String, String, Boolean, Boolean) | Sets various settings for the .PDB symbols used by Visual Studio for debugging and forces reloading of all symbols. |
|
StepInto(Boolean) | (Inherited from Debugger4.) |
|
StepInto(Boolean) | Steps into the next function call, if possible. |
|
StepOut(Boolean) | (Inherited from Debugger4.) |
|
StepOut(Boolean) | Steps out of the current function. |
|
StepOver(Boolean) | (Inherited from Debugger4.) |
|
StepOver(Boolean) | Steps over the next function call. |
|
Stop(Boolean) | (Inherited from Debugger4.) |
|
Stop(Boolean) | Stops debugging and terminates or detaches from all attached processes. |
|
TerminateAll() | (Inherited from Debugger4.) |
|
TerminateAll() | Terminates all currently running debugging processes. |
|
WriteMinidump(String, dbgMinidumpOption) | (Inherited from Debugger4.) |
|
WriteMinidump(String, dbgMinidumpOption) | If debugging a program and in Break mode, this function creates a minidump of the current debugging session. |
Top
Remarks
The debugger is available through the DTE2 object through its Debugger property. (You must cast this object to Debugger5. One debugger object is available for each instance of the interactive development environment (IDE).
To use Debugger5, you must add a reference to EnvDTE100.dll. For native development, you must add a reference to dte100.tlb.