Microsoft.VisualStudio.DebuggerVisualizers 命名空间
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
类
DialogDebuggerVisualizer |
所有自定义调试器可视化工具都必须派生自此类,并提供由 VS 调用的无参数构造函数。 |
VisualizerDevelopmentHost |
托管自定义可视化工具开发期间用于测试的主机类。 |
VisualizerObjectSource |
提供对要可视化的对象的访问权限。 |
VisualizerObjectSourceException |
表示从调试对象端引发的异常 - 通过 EE、可视化工具基础结构 (debuggee 主机) 或 debuggee 用户代码,并在 UI 端引发, (可从 DialogDebuggerVisualizer) 捕获。 它是与 Microsoft.VisualStudio.VIL.VisualStudioHost.DebuggeeVisualizerException 大致等效的 UI。 |
接口
IAsyncVisualizerObjectProvider |
为 中 IVisualizerObjectProvider2 定义的方法提供异步实现,提供将数据从调试者传递到可视化工具的功能,反之亦然。 |
IDeserializableObject |
当二进制或 JSON) 的基础格式 (未知时,用于反序列化对象的接口。 |
IDialogVisualizerService |
提供可视化工具可以调用以显示 System.Windows 窗体、对话框和控件的方法。 |
IVisualizerObjectProvider |
将调试对象中的对象数据提供给可视化工具。 |
IVisualizerObjectProvider2 |
提供将数据从调试对象传递到可视化工具的其他功能。 |
IVisualizerObjectProvider3 |
允许可视化工具调试器和调试程序端组件协调要使用的序列化机制,并提供将数据传递到调试对象端的其他功能,同时考虑 SelectedFormatterPolicy。 |
枚举
FormatterPolicy |
从 VisualizerObjectSource 序列化/反序列化信息时要使用的格式设置样式。 |
示例
public class DebuggerSide : DialogDebuggerVisualizer
{
override protected void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)
{
MessageBox.Show(objectProvider.GetObject().ToString());
}
// . . . Other methods omitted for clarity.
}
注解
可视化工具是 Visual Studio 调试器用于以有意义的方式显示特定数据类型的对象的小型程序。 为了可视化对象,可视化工具使用调试器进程中运行的代码 (调试器端) ,而正在调试的进程中的代码 (调试器端) 。
调试器端和调试程序端使用 VisualizerObjectSource 和 IVisualizerObjectProvider 相互通信。
调试对象端使用 VisualizerObjectSource 为调试器端指定 VisualizerObjectSource 对象。 调试器端通过调用接口上 IVisualizerObjectProvider 的方法来请求并接收此信息。
可视化工具可以编辑和显示数据。 如果可视化工具支持编辑数据,则必须通过使用 TransferDataTransferObject或 调用ReplaceData或ReplaceObject将数据传输回调试对象来完全替换数据。 如果要将数据保存回来,还需要创建自己的对象源。