Debugger4 接口
Debugger4 用于询问和操作调试器和正在调试的程序的状态。 Debugger4 取代了 Debugger3 接口。
命名空间： EnvDTE90a
程序集： EnvDTE90a（在 EnvDTE90a.dll 中）
语法
声明
<GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")> _
Public Interface Debugger4 _
Inherits Debugger3
[GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")]
public interface Debugger4 : Debugger3
[GuidAttribute(L"133BAD54-8E8D-451B-9DB0-AF38ED9819CC")]
public interface class Debugger4 : Debugger3
[<GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")>]
type Debugger4 =
interface
interface Debugger3
end
public interface Debugger4 extends Debugger3
Debugger4 类型公开以下成员。
属性
| 名称 | 说明 | |
|---|---|---|
.gif "公共属性") |
AllBreakpointsLastHit | 获取最后同时命中的绑定断点的集合。 （继承自 Debugger3。） |
|
AllBreakpointsLastHit | 获取最后同时命中的绑定断点的集合。 |
|
BreakpointLastHit | 获取最后命中的断点。 （继承自 Debugger3。） |
|
BreakpointLastHit | 获取最后命中的断点。若要获取同时命中的多个断点的集合，请参见 AllBreakpointsLastHit。 |
|
Breakpoints | 获取断点的集合。 （继承自 Debugger3。） |
|
Breakpoints | 获取断点的集合。 |
|
CurrentMode | 获取 IDE 上下文中调试器的当前模式。 （继承自 Debugger3。） |
|
CurrentMode | 获取 IDE 上下文中调试器的当前模式。 |
|
CurrentProcess | 获取或设置活动进程。 （继承自 Debugger3。） |
|
CurrentProcess | 获取或设置活动进程。 |
|
CurrentProgram | 设置或返回活动程序。 （继承自 Debugger3。） |
|
CurrentProgram | 设置或返回活动程序。 |
|
CurrentStackFrame | 获取或设置当前的堆栈帧。 （继承自 Debugger3。） |
|
CurrentStackFrame | 获取或设置当前的堆栈帧。 |
|
CurrentThread | 获取或设置当前正在调试的线程。 （继承自 Debugger3。） |
|
CurrentThread | 获取或设置当前正在调试的线程。 |
|
DebuggedProcesses | 获取正在调试的进程的列表。 （继承自 Debugger3。） |
|
DebuggedProcesses | 获取当前正在调试的进程的列表。 |
|
DTE | 获取顶级扩展性对象。 （继承自 Debugger3。） |
|
DTE | 获取顶级扩展性对象。 |
|
ExceptionGroups | 获取调试器的异常设置。对于每个异常，这些设置决定在调试器中断执行之前调试器是否为代码提供处理异常的机会。 （继承自 Debugger3。） |
|
ExceptionGroups | 获取调试器的异常设置。对于每个异常，这些设置决定在调试器中断执行之前调试器是否为代码提供处理异常的机会。 |
|
ForceContinue | 获取或设置一个值，该值决定在跟踪点或断点完成执行宏的过程后调试器是中断还是继续。默认行为是由用户在创建跟踪点或断点时在对话框中设置的。此属性可用于更改该默认行为。 （继承自 Debugger3。） |
|
ForceContinue | 获取或设置一个值，该值决定在跟踪点或断点完成执行宏的过程后调试器是中断还是继续。默认行为是由用户在创建跟踪点或断点时在对话框中设置的。此属性可用于更改该默认行为。 |
|
HexDisplayMode | 获取或设置一个值，该值指示是以十六进制还是以十进制格式输出表达式。 （继承自 Debugger3。） |
|
HexDisplayMode | 获取或设置一个值，该值指示是以十六进制还是以十进制格式输出表达式。 |
|
HexInputMode | 获取或设置一个值，该值指示是以十六进制还是以十进制格式计算表达式。 （继承自 Debugger3。） |
|
HexInputMode | 获取或设置一个值，该值指示是以十六进制还是以十进制格式计算表达式。 |
|
Languages | 获取调试器所支持的语言的列表。 （继承自 Debugger3。） |
|
Languages | 获取调试器所支持的语言的列表。 |
|
LastBreakReason | 获取程序中断的最终原因。如果程序正在运行，它将返回 DBG_REASON_NONE。 （继承自 Debugger3。） |
|
LastBreakReason | 获取程序中断的最终原因。如果程序正在运行，它将返回 DBG_REASON_NONE。 |
|
LocalProcesses | 获取此计算机上当前正在运行的进程的列表。 （继承自 Debugger3。） |
|
LocalProcesses | 获取此计算机上当前正在运行的进程的列表。 |
|
OnlyLoadSymbolsManually | 获取一个值，该值决定是手动还是自动加载符号。Visual Studio 用户可以在“选项”对话框中确定此设置。有关如何在 Visual Studio 中设置此值的更多信息，请参见如何：指定符号位置和加载行为。 （继承自 Debugger3。） |
|
OnlyLoadSymbolsManually | 获取一个值，该值决定是手动还是自动加载符号。Visual Studio 用户可以在“选项”对话框中确定此设置。有关如何在 Visual Studio 中设置此值的更多信息，请参见如何：指定符号位置和加载行为。 |
|
Parent | 获取 Debugger3 对象的直接父对象（DTE2）。 （继承自 Debugger3。） |
|
Parent | 获取 Debugger4 对象的直接父对象（DTE2）。 |
|
SymbolCachePath | 获取一个字符串，该字符串包含您在从符号服务器下载符号时 Visual Studio 所用的符号缓存的路径。您可以在“选项”对话框中指定符号缓存路径。有关更多信息，请参见 如何：使用符号服务器。 （继承自 Debugger3。） |
|
SymbolCachePath | 获取一个字符串，该字符串包含您在从符号服务器下载符号时 Visual Studio 所用的符号缓存的路径。您可以在“选项”对话框中指定符号缓存路径。有关更多信息，请参见 如何：使用符号服务器。 |
|
SymbolPath | 获取一个字符串，该字符串包含 Visual Studio 进行调试时所用的 .PDB 符号文件的路径。Visual Studio 用户可以在“选项”对话框中指定符号路径。有关更多信息，请参见如何：指定符号位置和加载行为。 （继承自 Debugger3。） |
|
SymbolPath | 获取一个字符串，该字符串包含 Visual Studio 进行调试时所用的 .PDB 符号文件的路径。Visual Studio 用户可以在“选项”对话框中指定符号路径。有关更多信息，请参见如何：指定符号位置和加载行为。 |
|
SymbolPathState | 获取一个字符串，该字符串表示 Visual Studio 进行调试时所用的 .PDB 符号文件的所有符号路径的状态。 （继承自 Debugger3。） |
|
SymbolPathState | 获取一个字符串，该字符串表示 Visual Studio 进行调试时所用的 .PDB 符号文件的所有符号路径的状态。 |
|
Transports | 获取支持的调试传输的集合。 （继承自 Debugger3。） |
|
Transports | 获取支持的调试传输的集合。 |
页首
方法
| 名称 | 说明 | |
|---|---|---|
.gif "公共方法") |
Break(Boolean) | 使给定进程暂停执行以便可以分析其当前状态。 （继承自 Debugger3。） |
|
Break(Boolean) | 使给定进程暂停执行以便可以分析其当前状态。 |
|
DetachAll() | 从所有附加程序分离出来。 （继承自 Debugger3。） |
|
DetachAll() | 从所有附加程序分离出来。 |
|
ExecuteStatement(String, Int32, Boolean) | 执行指定的语句。如果 TreatAsExpression 标志为 true，那么字符串将被解释为表达式，且输出被发送至 “命令”窗口。 （继承自 Debugger3。） |
|
ExecuteStatement(String, Int32, Boolean) | 执行指定的语句。如果 TreatAsExpression 标志为 true，那么字符串将被解释为表达式，且输出被发送至 “命令”窗口。 |
|
GetExpression(String, Boolean, Int32) | 根据当前的堆栈帧计算表达式。如果表达式可以进行分析但无法计算，则将返回不包含有效值的对象。 （继承自 Debugger3。） |
|
GetExpression(String, Boolean, Int32) | 根据当前的堆栈帧计算表达式。如果表达式可以进行分析但无法计算，则将返回不包含有效值的对象。 |
|
GetExpression2(String, Boolean, Boolean, Int32) | 根据当前的堆栈帧计算表达式。如果表达式可以进行分析但无法计算，则将返回不包含有效值的对象。此成员函数与 GetExpression 类似，只是它另外还有一个布尔型参数，可以将此参数设置为 true，以指示表达式的计算结果为一个语句。 （继承自 Debugger3。） |
|
GetExpression2(String, Boolean, Boolean, Int32) | 根据当前的堆栈帧计算表达式。如果表达式可以进行分析但无法计算，则将返回不包含有效值的对象。此方法与 GetExpression 类似，只是它另外还有一个布尔型参数，可以将此参数设置为 true，以指示表达式的计算结果为一个语句。 |
|
GetExpression3 | 计算表达式，与 GetExpression 类似。但是，此方法允许调用方指定将执行计算操作的堆栈帧。它还允许调用方指定是否应执行属性和隐式函数调用的自动计算。 |
|
GetProcesses(Transport, String) | （继承自 Debugger3。） |
|
GetProcesses(Transport, String) | 获取一个对象，该对象表示指定的传输上当前为进行调试而连接的进程。 |
|
Go(Boolean) | 从当前语句开始执行程序。 （继承自 Debugger3。） |
|
Go(Boolean) | 从当前语句开始执行程序。 |
|
RunToCursor(Boolean) | 执行程序直至源文件光标的当前位置。 （继承自 Debugger3。） |
|
RunToCursor(Boolean) | 执行程序直至源文件光标的当前位置。 |
|
SetNextStatement() | 根据当前源文件中的光标位置设置要执行的下一个指令。 （继承自 Debugger3。） |
|
SetNextStatement() | 根据当前源文件中的光标位置设置要执行的下一个指令。 |
|
SetSymbolSettings(String, String, String, Boolean, Boolean) | 为 Visual Studio 使用的 .PDB 符号设置不同的设置以进行调试，并强制重新加载所有符号。 （继承自 Debugger3。） |
|
SetSymbolSettings(String, String, String, Boolean, Boolean) | 为 Visual Studio 使用的 .PDB 符号设置不同的设置以进行调试，并强制重新加载所有符号。 |
|
StepInto(Boolean) | 如果可能，单步执行下一个函数调用。 （继承自 Debugger3。） |
|
StepInto(Boolean) | 如果可能，单步执行下一个函数调用。 |
|
StepOut(Boolean) | 跳出当前函数。 （继承自 Debugger3。） |
|
StepOut(Boolean) | 跳出当前函数。 |
|
StepOver(Boolean) | 转到下一个函数调用。 （继承自 Debugger3。） |
|
StepOver(Boolean) | 转到下一个函数调用。 |
|
Stop(Boolean) | 停止调试，并终止所有附加的进程或从所有附加的进程分离出来。 （继承自 Debugger3。） |
|
Stop(Boolean) | 停止调试，并终止所有附加的进程或从所有附加的进程分离出来。 |
|
TerminateAll() | 终止当前正在运行的所有调试进程。 （继承自 Debugger3。） |
|
TerminateAll() | 终止当前正在运行的所有调试进程。 |
|
WriteMinidump(String, dbgMinidumpOption) | （继承自 Debugger3。） |
|
WriteMinidump(String, dbgMinidumpOption) | 如果正在调试程序且处于中断模式下，则此函数将为当前调试会话创建一个小型转储。 |
页首
备注
调试器可以通过 DTE2 对象的 Debugger 属性获得。 对于交互式开发环境 (IDE) 的每个实例，均有一个调试器对象可用。
若要使用 Debugger4，则必须添加一个对 EnvDTE90a.dll 的引用。 对于本机开发，必须添加一个对 dte90a.tlb 的引用。
示例
请参见 Debugger3。