VS2017扩展开发：捕获文档切换事件实现XML代码大纲

嘿，我来帮你梳理下这个问题！

一、是否有必要挂钩文档/视图切换事件？ #

完全有必要！你需要实时感知用户当前操作的文档类型，只有切换到XML文档时才加载渲染大纲，这样能避免不必要的资源消耗，也能保证扩展只在合适场景下工作——总不能用户打开C#或TXT文件时，你也去尝试生成XML大纲对吧？

二、解决Package.GetGlobalService的报错问题 #

你遇到的“对象不包含GetGlobalService定义”错误，是因为ToolWindowPane本身没有直接的GetGlobalService方法，这个方法属于Package类，但你的OutlineWindow继承自ToolWindowPane，不能直接调用Package.GetGlobalService。正确的做法是通过ToolWindowPane的Site属性获取服务：

修改构造函数代码：

public OutlineWindow() : base(null)
{
    this.Caption = "OutlineWindow";
    this.Content = new OutlineWindowControl();
    
    // 正确获取DTE服务的方式
    dte = this.Site.GetService(typeof(EnvDTE.DTE)) as EnvDTE.DTE;
    if (dte != null)
    {
        dte.Events.WindowEvents.WindowActivated += OnWindowActivated;
        // 额外建议：监听DocumentEvents更精准捕捉文档切换/打开
        dte.Events.DocumentEvents.DocumentOpened += OnDocumentOpened;
        dte.Events.DocumentEvents.DocumentActivated += OnDocumentActivated;
    }
}

三、更精准的事件选择：WindowEvents vs DocumentEvents #

你当前用的WindowActivated会捕捉所有窗口切换（包括工具窗口），如果只想针对代码文档的切换，DocumentEvents下的DocumentActivated会更精准：

• DocumentActivated：用户切换不同文档标签时触发，直接拿到当前激活的Document对象
• DocumentOpened：用户打开新文档时触发，适合初始化大纲

四、判断XML文档的逻辑 #

在事件回调里，你可以通过文件后缀或文档语言属性判断是否为XML文档：

private void OnDocumentActivated(Document document)
{
    if (document == null) return;
    
    // 方式1：通过文件后缀判断
    bool isXmlDoc = document.FullName.EndsWith(".xml", StringComparison.OrdinalIgnoreCase);
    
    // 方式2：通过文档语言判断（更可靠，避免无.xml后缀的XML文件）
    bool isXmlLanguage = document.Language.Equals("XML", StringComparison.OrdinalIgnoreCase);
    
    if (isXmlDoc || isXmlLanguage)
    {
        // 这里编写XML大纲创建和渲染逻辑
        RenderXmlOutline(document);
    }
    else
    {
        // 切换到非XML文档时，清空大纲或隐藏工具窗口
        ClearOutline();
    }
}

private void RenderXmlOutline(Document xmlDoc)
{
    // 读取XML内容、解析节点、生成交互式大纲的逻辑
    // 示例：获取TextDocument对象读取内容
    TextDocument textDoc = xmlDoc.Object("TextDocument") as TextDocument;
    string xmlContent = textDoc.StartPoint.CreateEditPoint().GetText(textDoc.EndPoint);
    // 后续解析XML并渲染到OutlineWindowControl中
}

五、额外注意事项 #

• 记得在工具窗口销毁时取消事件订阅，避免内存泄漏：

protected override void Dispose(bool disposing)
{
    if (disposing && dte != null)
    {
        dte.Events.WindowEvents.WindowActivated -= OnWindowActivated;
        dte.Events.DocumentEvents.DocumentOpened -= OnDocumentOpened;
        dte.Events.DocumentEvents.DocumentActivated -= OnDocumentActivated;
    }
    base.Dispose(disposing);
}

• 如果你的扩展需要支持VS2019及以上，还可以考虑使用IVsRunningDocumentTable（RDT）监听文档变化，它比DTE事件更底层可靠，但使用稍复杂。不过对于你的场景，DTE事件已经足够便捷。

内容的提问来源于stack exchange，提问作者TheLogan