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

页首

方法

	名称	说明
	Break(Boolean)	（继承自 Debugger。）
	Break(Boolean)	使给定进程暂停执行以便可以分析其当前状态。
	DetachAll()	（继承自 Debugger。）
	DetachAll()	从所有附加程序分离出来。
	ExecuteStatement(String, Int32, Boolean)	（继承自 Debugger。）
	ExecuteStatement(String, Int32, Boolean)	执行指定的语句。如果 TreatAsExpression 标志为 true，那么字符串将被解释为表达式，且输出被发送至 “命令”窗口。
	GetExpression(String, Boolean, Int32)	（继承自 Debugger。）
	GetExpression(String, Boolean, Int32)	根据当前的堆栈帧计算表达式。如果表达式可以进行分析但无法计算，则将返回不包含有效值的对象。
	GetExpression2	根据当前的堆栈帧计算表达式。如果表达式可以进行分析但无法计算，则将返回不包含有效值的对象。
	GetProcesses	允许调用方从远程计算机获取进程的集合。
	Go(Boolean)	（继承自 Debugger。）
	Go(Boolean)	从当前语句开始执行程序。
	RunToCursor(Boolean)	（继承自 Debugger。）
	RunToCursor(Boolean)	执行程序直至源文件光标的当前位置。
	SetNextStatement()	（继承自 Debugger。）
	SetNextStatement()	根据当前源文件中的光标位置设置要执行的下一个指令。
	StepInto(Boolean)	（继承自 Debugger。）
	StepInto(Boolean)	如果可能，单步执行下一个函数调用。
	StepOut(Boolean)	（继承自 Debugger。）
	StepOut(Boolean)	跳出当前函数。
	StepOver(Boolean)	（继承自 Debugger。）
	StepOver(Boolean)	转到下一个函数调用。
	Stop(Boolean)	（继承自 Debugger。）
	Stop(Boolean)	停止调试，并终止所有附加的进程或从所有附加的进程分离出来。
	TerminateAll()	（继承自 Debugger。）
	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 命名空间