Debugger4 Interface

 

Debugger4 is used to interrogate and manipulate the state of the debugger and the program being debugged. Debugger4 supersedes the Debugger3 interfaces.

Namespace:   EnvDTE90a
Assembly:  EnvDTE90a (in EnvDTE90a.dll)

[GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")]
public interface Debugger4 : Debugger3

NameDescription
System_CAPS_pubpropertyAllBreakpointsLastHit

Gets a collection of bound breakpoints that were last simultaneously hit.

System_CAPS_pubpropertyBreakpointLastHit

Gets the last breakpoint hit. To get a collection of multiple breakpoints hit simultaneously, see AllBreakpointsLastHit.

System_CAPS_pubpropertyBreakpoints

Gets a collection of breakpoints.

System_CAPS_pubpropertyCurrentMode

Gets the current mode of the debugger within the context of the IDE.

System_CAPS_pubpropertyCurrentProcess

Gets or sets the active process.

System_CAPS_pubpropertyCurrentProgram

Sets or returns the active program.

System_CAPS_pubpropertyCurrentStackFrame

Gets or sets the current stack frame.

System_CAPS_pubpropertyCurrentThread

Gets or sets the current thread being debugged.

System_CAPS_pubpropertyDebuggedProcesses

Gets the list of processes that are currently being debugged.

System_CAPS_pubpropertyDTE

Gets the top-level extensibility object.

System_CAPS_pubpropertyExceptionGroups

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.

System_CAPS_pubpropertyForceContinue

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.

System_CAPS_pubpropertyHexDisplayMode

Gets or sets a value that indicates whether the expressions are output in hexadecimal or decimal format.

System_CAPS_pubpropertyHexInputMode

Gets or sets a value that indicates whether the expressions are evaluated in hexadecimal or decimal format.

System_CAPS_pubpropertyLanguages

Gets a list of languages that the debugger supports.

System_CAPS_pubpropertyLastBreakReason

Gets the last reason that a program was broken. If the program is running, it returns DBG_REASON_NONE.

System_CAPS_pubpropertyLocalProcesses

Gets the list of processes that are currently running on this computer.

System_CAPS_pubpropertyOnlyLoadSymbolsManually

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 .05384c85-d264-4e18-abaa-aa482ab25470

System_CAPS_pubpropertyParent

Gets the immediate parent object of the Debugger4 object (DTE2).

System_CAPS_pubpropertySymbolCachePath

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 .cf3a450d-06b0-4054-a094-a0afb9652fbc

System_CAPS_pubpropertySymbolPath

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 .05384c85-d264-4e18-abaa-aa482ab25470

System_CAPS_pubpropertySymbolPathState

Gets a string that represents the state of all symbol paths for the .PDB symbol files that are used by Visual Studio for debugging.

System_CAPS_pubpropertyTransports

Gets a collection of supported debugging transports.

NameDescription
System_CAPS_pubmethodBreak(Boolean)

Causes the given process to pause its execution so that its current state can be analyzed.

System_CAPS_pubmethodDetachAll()

Detaches from all attached programs.

System_CAPS_pubmethodExecuteStatement(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.

System_CAPS_pubmethodGetExpression(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.

System_CAPS_pubmethodGetExpression2(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.

System_CAPS_pubmethodGetExpression3(String, StackFrame, Boolean, Boolean, Boolean, Int32)

Evaluates an expression, similar to M:EnvDTE90.Debugger2.GetExpression(System.String,System.Boolean,System.Boolean,System.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.

System_CAPS_pubmethodGetProcesses(Transport, String)

Gets an object that represents the processes that are currently connected for debugging on the specified transport.

System_CAPS_pubmethodGo(Boolean)

Starts executing the program from the current statement.

System_CAPS_pubmethodRunToCursor(Boolean)

Executes the program to the current position of the source file cursor.

System_CAPS_pubmethodSetNextStatement()

Sets the next instruction to be executed, according to the cursor position in the current source file.

System_CAPS_pubmethodSetSymbolSettings(String, String, String, Boolean, Boolean)

Sets various settings for the .PDB symbols used by Visual Studio for debugging and forces reloading of all symbols.

System_CAPS_pubmethodStepInto(Boolean)

Steps into the next function call, if possible.

System_CAPS_pubmethodStepOut(Boolean)

Steps out of the current function.

System_CAPS_pubmethodStepOver(Boolean)

Steps over the next function call.

System_CAPS_pubmethodStop(Boolean)

Stops debugging and terminates or detaches from all attached processes.

System_CAPS_pubmethodTerminateAll()

Terminates all currently running debugging processes.

System_CAPS_pubmethodWriteMinidump(String, dbgMinidumpOption)

If debugging a program and in Break mode, this function creates a minidump of the current debugging session.

The debugger is available through the DTE2 object through its Debugger property. One debugger object is available for each instance of the interactive development environment (IDE).

To use Debugger4, you must add a reference to EnvDTE90a.dll. For native development, you must add a reference to dte90a.tlb.

Return to top
Show: