Debugger2 接口

Debugger2 对象用于询问和操作调试器和正在调试的程序的状态。 Debugger2 取代了 Debugger 对象。

命名空间:  EnvDTE80
程序集:  EnvDTE80(在 EnvDTE80.dll 中)

语法

声明
<GuidAttribute("8B5E2BFD-4642-4EFE-8AF4-0B2DA9AAA23C")> _
Public Interface Debugger2 _
    Inherits Debugger
[GuidAttribute("8B5E2BFD-4642-4EFE-8AF4-0B2DA9AAA23C")]
public interface Debugger2 : Debugger
[GuidAttribute(L"8B5E2BFD-4642-4EFE-8AF4-0B2DA9AAA23C")]
public interface class Debugger2 : Debugger
[<GuidAttribute("8B5E2BFD-4642-4EFE-8AF4-0B2DA9AAA23C")>]
type Debugger2 =  
    interface 
        interface Debugger 
    end
public interface Debugger2 extends Debugger

Debugger2 类型公开以下成员。

属性

  名称 说明
公共属性 AllBreakpointsLastHit 获取最后同时命中的绑定断点的集合。
公共属性 BreakpointLastHit 获取最后命中的断点。
公共属性 Breakpoints 获取断点的集合。
公共属性 CurrentMode 获取 IDE 上下文中调试器的当前模式。
公共属性 CurrentProcess 获取或设置活动进程。
公共属性 CurrentProgram 设置或返回活动程序。
公共属性 CurrentStackFrame 获取或设置当前的堆栈帧。
公共属性 CurrentThread 获取或设置当前正在调试的线程。
公共属性 DebuggedProcesses 获取当前正在调试的进程的列表。
公共属性 DTE 获取顶级扩展性对象。
公共属性 HexDisplayMode 获取或设置一个值,该值指示是以十六进制还是以十进制格式输出表达式。
公共属性 HexInputMode 获取或设置一个值,该值指示是以十六进制还是以十进制格式计算表达式。
公共属性 Languages 获取调试器所支持的语言的列表。
公共属性 LastBreakReason 获取程序中断的最终原因。如果程序正在运行,它将返回 DBG_REASON_NONE
公共属性 LocalProcesses 获取该计算机上当前正在运行的进程列表。
公共属性 Parent 获取 Debugger2 对象 (DTE2) 的直接父对象。
公共属性 Transports 获取支持的调试传输的集合。

页首

方法

  名称 说明
公共方法 Break 使给定进程暂停执行以便可以分析其当前状态。
公共方法 DetachAll 从所有附加的程序中分离。
公共方法 ExecuteStatement 执行指定的语句。如果 TreatAsExpression 标志为 true,那么字符串将被解释为表达式,且输出被发送至 “命令”窗口
公共方法 GetExpression 根据当前堆栈帧计算表达式。如果表达式可以进行分析但无法计算,则将返回不包含有效值的对象。
公共方法 GetExpression2 根据当前堆栈帧计算表达式。如果表达式可以进行分析但无法计算,则将返回不包含有效值的对象。
公共方法 GetProcesses 允许调用方从远程计算机获取进程的集合。
公共方法 Go 从当前语句开始执行程序。
公共方法 RunToCursor 将程序执行到源文件光标的当前位置。
公共方法 SetNextStatement 根据当前源文件中的光标位置设置要执行的下一个指令。
公共方法 StepInto 如果可能,单步执行下一个函数调用。
公共方法 StepOut 跳出当前函数。
公共方法 StepOver 转到下一个函数调用。
公共方法 Stop 停止调试,并终止所有附加的进程或从所有附加的进程分离出来。
公共方法 TerminateAll 终止当前正在运行的所有调试进程。
公共方法 WriteMinidump 如果正在调试程序且处于中断模式下,则此函数将为当前调试会话创建一个小型转储。

页首

备注

可以通过 DTE2 对象的 Debugger 属性使用调试器,如下面的示例所示。 对于开发环境的每个实例,均有一个调试器对象可用。

示例

Imports EnvDTE
Imports System.Diagnostics

Public Module Module1
    'This function returns true if the debugger is actively debugging.

    Function IsDebugging() As Boolean
        Dim debugger As EnvDTE80.Debugger2 
        debugger = DTE2.Debugger

        If (debugger Is Nothing) Then
            MsgBox("Debugger doesn't exist! Fatal error.")
            IsDebugging = false
        Else
            IsDebugging = (debugger.CurrentMode <> _
            dbgDebugMode.dbgDesignMode)
        End If
    End Function
End Module
// The following C++ program can be run from the command line.
// It detects whether an instance of Visual Studio is currently 
// running,and if so, prints a message stating whether its debugger
// is actively debugging.

#include <stdio.h>
#import "dte.olb" raw_interfaces_only named_guids
using namespace EnvDTE80;
int main(void)
{
    int nRet = 0;
    CoInitialize(NULL);
    IUnknownPtr pUnk;
    GetActiveObject(CLSID_DTE, NULL, &pUnk);
    if (pUnk == NULL) {
        printf ("No instance of Visual Studio is running.\n");
    }
    else {
        _DTEPtr pDTE = pUnk;
        if (pDTE) {
            DebuggerPtr pDebugger;
            if (SUCCEEDED(pDTE->get_Debugger(&pDebugger2)) && 
            pDebugger2
            != NULL){
                dbgDebugMode mode;
                if (SUCCEEDED(pDebugger2->get_CurrentMode(&mode))) {
                    if (mode != dbgDesignMode) {
                        printf("Debugger is active.\n");
                        nRet = 1;
                    }
                    else {
                        printf("Debugger is not active.\n");
                    }
                }
            }
        }
    }
    CoUninitialize();
    return nRet;
}

请参阅

参考

EnvDTE80 命名空间