Share via

Debugger3 接口

  • 项目

Debugger3 用于询问和操作调试器和正在调试的程序的状态。 Debugger3 将取代 Debugger2 和 Debugger 接口。

命名空间：  EnvDTE90
程序集：  EnvDTE90（在 EnvDTE90.dll 中）

语法

声明
<GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")> _
Public Interface Debugger3 _
    Inherits Debugger2

[GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")]
public interface Debugger3 : Debugger2

[GuidAttribute(L"87DFC8DA-67B4-4954-BB89-6A277A50BAFC")]
public interface class Debugger3 : Debugger2

[<GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")>]
type Debugger3 =  
    interface 
        interface Debugger2 
    end

public interface Debugger3 extends Debugger2

Debugger3 类型公开以下成员。

属性

  名称 说明
公共属性 AllBreakpointsLastHit 获取最后同时命中的绑定断点的集合。
公共属性 BreakpointLastHit 获取最后命中的断点。
公共属性 Breakpoints 获取断点的集合。
公共属性 CurrentMode 获取 IDE 上下文中调试器的当前模式。
公共属性 CurrentProcess 获取或设置活动进程。
公共属性 CurrentProgram 设置或返回活动程序。
公共属性 CurrentStackFrame 获取或设置当前的堆栈帧。
公共属性 CurrentThread 获取或设置当前正在调试的线程。
公共属性 DebuggedProcesses 获取正在调试的进程的列表。
公共属性 DTE 获取顶级扩展性对象。
公共属性 ExceptionGroups 获取调试器的异常设置。对于每个异常，这些设置决定在调试器中断执行之前调试器是否为代码提供处理异常的机会。
公共属性 ForceContinue 获取或设置一个值，该值决定在跟踪点或断点完成执行宏的过程后调试器是中断还是继续。默认行为是由用户在创建跟踪点或断点时在对话框中设置的。此属性可用于更改该默认行为。
公共属性 HexDisplayMode 获取或设置一个值，该值指示是以十六进制还是以十进制格式输出表达式。
公共属性 HexInputMode 获取或设置一个值，该值指示是以十六进制还是以十进制格式计算表达式。
公共属性 Languages 获取调试器所支持的语言的列表。
公共属性 LastBreakReason 获取程序中断的最终原因。如果程序正在运行，它将返回 DBG_REASON_NONE。
公共属性 LocalProcesses 获取此计算机上当前正在运行的进程的列表。
公共属性 OnlyLoadSymbolsManually 获取一个值，该值决定是手动还是自动加载符号。Visual Studio 用户可以在“选项”对话框中确定此设置。有关如何在 Visual Studio 中设置此值的更多信息，请参见[OBSOLETE] 如何：指定符号位置和加载行为。
公共属性 Parent 获取 Debugger3 对象的直接父对象（DTE2）。
公共属性 SymbolCachePath 获取一个字符串，该字符串包含您在从符号服务器下载符号时 Visual Studio 所用的符号缓存的路径。您可以在“选项”对话框中指定符号缓存路径。有关详细信息，请参阅[OBSOLETE] 如何：使用符号服务器。
公共属性 SymbolPath 获取一个字符串，该字符串包含 Visual Studio 进行调试时所用的 .PDB 符号文件的路径。Visual Studio 用户可以在“选项”对话框中指定符号路径。有关详细信息，请参阅[OBSOLETE] 如何：指定符号位置和加载行为。
公共属性 SymbolPathState 获取一个字符串，该字符串表示 Visual Studio 进行调试时所用的 .PDB 符号文件的所有符号路径的状态。
公共属性 Transports 获取支持的调试传输的集合。

页首

方法

  名称 说明
公共方法 Break 使给定进程暂停执行以便可以分析其当前状态。
公共方法 DetachAll 从所有附加的程序中分离。
公共方法 ExecuteStatement 执行指定的语句。如果 TreatAsExpression 标志为 true，那么字符串将被解释为表达式，且输出被发送至 “命令”窗口。
公共方法 GetExpression 根据当前堆栈帧计算表达式。如果表达式可以进行分析但无法计算，则将返回不包含有效值的对象。
公共方法 GetExpression2 根据当前堆栈帧计算表达式。如果表达式可以进行分析但无法计算，则将返回不包含有效值的对象。此成员函数与 GetExpression 类似，只是它另外还有一个布尔型参数，可以将此参数设置为 true，以指示表达式的计算结果为一个语句。
公共方法 GetProcesses
公共方法 Go 从当前语句开始执行程序。
公共方法 RunToCursor 将程序执行到源文件光标的当前位置。
公共方法 SetNextStatement 根据当前源文件中的光标位置设置要执行的下一个指令。
公共方法 SetSymbolSettings 为 Visual Studio 使用的 .PDB 符号设置不同的设置以进行调试，并强制重新加载所有符号。
公共方法 StepInto 如果可能，单步执行下一个函数调用。
公共方法 StepOut 跳出当前函数。
公共方法 StepOver 转到下一个函数调用。
公共方法 Stop 停止调试，并终止所有附加的进程或从所有附加的进程分离出来。
公共方法 TerminateAll 终止当前正在运行的所有调试进程。
公共方法 WriteMinidump

页首

备注

调试器可通过 DTE2 对象的 Debugger 属性获得，如下面的示例所示。 对于交互式开发环境 (IDE) 的每个实例，均有一个调试器对象可用。

示例

Imports System
Imports EnvDTE
Imports EnvDTE90
Imports EnvDTE90
Imports System.Diagnostics

Public Module Module1
    'This function returns true if the debugger is actively debugging.
    Function IsDebugging() As Boolean
        Dim debugger As EnvDTE90.Debugger3 
        debugger = DTE.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 "dte90.olb" raw_interfaces_only named_guids
using namespace EnvDTE90;
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(&pDebugger3)) && 
            pDebugger3
            != NULL){
                dbgDebugMode mode;
                if (SUCCEEDED(pDebugger3->get_CurrentMode(&mode))) {
                    if (mode != dbgDesignMode) {
                        printf("Debugger is active.\n");
                        nRet = 1;
                    }
                    else {
                        printf("Debugger is not active.\n");
                    }
                }
            }
        }
    }
    CoUninitialize();
    return nRet;
}

请参阅

参考

EnvDTE90 命名空间