如何设置VSTO Outlook加载项启动项？及Ribbon按钮启动显示问题

先帮你搞定按钮不显示的代码调整，再讲怎么设置启动项——你的现有代码里有个关键错误，这大概率是按钮不显示的核心原因。

一、修正按钮不显示的代码问题 #

你手动new了Outlook.Application()，这会创建一个独立的Outlook实例，和当前运行的Outlook完全脱节。另外，需要在ThisAddIn_Startup里绑定窗口事件，确保Ribbon能在所有Outlook窗口中正确加载。

修正后的ThisAddIn代码 #

public partial class ThisAddIn {
    EpicTest obj = new EpicTest();
    Outlook.Inspectors inspectors;
    // 移除手动创建的Application实例，用VSTO内置的this.Application
    private Outlook.Explorer explorer = null;

    private void ThisAddIn_Startup(object sender, EventArgs e) {
        // 绑定Inspectors事件，监听新邮件窗口打开
        inspectors = this.Application.Inspectors;
        inspectors.NewInspector += Inspectors_NewInspector;

        // 绑定Explorers事件，监听新导航窗口打开
        this.Application.Explorers.NewExplorer += Explorers_NewExplorer;

        // 激活当前已打开的Explorer窗口，触发Ribbon加载
        explorer = this.Application.ActiveExplorer();
        explorer?.Activate();
    }

    // 新邮件窗口打开时触发，刷新Ribbon确保按钮显示
    private void Inspectors_NewInspector(Outlook.Inspector Inspector) {
        // 可选：只在邮件窗口刷新Ribbon，根据你的需求调整
        if (Inspector.CurrentItem is Outlook.MailItem) {
            obj.Ribbon?.Invalidate();
        }
    }

    // 新导航窗口打开时触发，刷新Ribbon
    private void Explorers_NewExplorer(Outlook.Explorer Explorer) {
        explorer = Explorer;
        explorer.Activate();
        obj.Ribbon?.Invalidate();
    }

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject() {
        return obj; // 返回已实例化的对象，避免重复创建
    }

    private void InternalStartup() {
        this.Startup += new System.EventHandler(ThisAddIn_Startup);
        this.Shutdown += new System.EventHandler(ThisAddIn_Shutdown);
    }

    void timerDelay_Tick(object sender, EventArgs e) {
        // 保留你的定时器逻辑，如果没用可以考虑移除
    }

    private void ThisAddIn_Shutdown(object sender, EventArgs e) {
        // 注销事件防止内存泄漏
        if (inspectors != null) {
            inspectors.NewInspector -= Inspectors_NewInspector;
            inspectors = null;
        }
        if (this.Application.Explorers != null) {
            this.Application.Explorers.NewExplorer -= Explorers_NewExplorer;
        }
        explorer = null;
    }
}

补充：确保EpicTest类正确实现IRibbonExtensibility #

你的EpicTest类需要保存IRibbonUI实例以便刷新，示例代码如下：

public class EpicTest : Microsoft.Office.Core.IRibbonExtensibility {
    public Microsoft.Office.Core.IRibbonUI Ribbon { get; set; }

    public string GetCustomUI(string ribbonID) {
        // 根据窗口类型返回对应的Ribbon XML，这里是邮件窗口的示例
        if (ribbonID == "Microsoft.Outlook.Mail") {
            return @"<customUI xmlns=""http://schemas.microsoft.com/office/2009/07/customui"">
                <ribbon>
                    <tabs>
                        <tab id=""CustomTab"" label=""我的自定义标签"">
                            <group id=""CustomGroup"" label=""自定义功能"">
                                <button id=""TestButton"" label=""测试按钮"" 
                                        size=""large"" onAction=""OnTestButtonClick"" />
                            </group>
                        </tab>
                    </tabs>
                </ribbon>
            </customUI>";
        }
        // 其他窗口类型返回空或对应XML
        return string.Empty;
    }

    public void Ribbon_Load(Microsoft.Office.Core.IRibbonUI ribbonUI) {
        this.Ribbon = ribbonUI;
    }

    public void OnTestButtonClick(Microsoft.Office.Core.IRibbonControl control) {
        // 按钮点击逻辑
        MessageBox.Show("自定义按钮被触发啦！");
    }
}

二、设置加载项为启动项 #

1. 开发调试时（Visual Studio中） #

• 右键点击你的VSTO项目 → 选择「属性」。
• 切换到「调试」选项卡，在「启动外部程序」处点击「浏览」。
• 找到Outlook的安装路径，比如Office 2016/365的路径通常是：C:\Program Files\Microsoft Office\root\Office16\OUTLOOK.EXE（根据你的Office版本调整）。
• 保存设置后，点击「启动调试」，Visual Studio会自动启动Outlook并加载你的加载项。

2. 部署后让Outlook自动加载 #

• 发布加载项后，安装包会自动注册到COM加载项列表。如果没自动注册，手动添加步骤：
  1. 打开Outlook → 点击「文件」→「选项」→「加载项」。
  2. 底部「管理」下拉选「COM加载项」，点击「转到」。
  3. 点击「添加」，找到你加载项的.dll文件（一般在项目的bin\Release或bin\Debug文件夹），选中后确定。
  4. 确保加载项在列表中被勾选，这样Outlook启动时就会自动加载它。

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