基于C#为OneNote Desktop开发带自定义UI的功能区按钮插件的可行性

用例概述 #

• 用户在OneNote中输入文本
• 用户点击自定义功能区按钮
• 点击按钮后打开自定义UI（如WPF或WinForms）
• 该UI读取当前笔记本内容并支持额外输入
• 将来自OneNote和自定义UI的数据发送至外部Web服务

遇到的挑战 #

• 未找到针对OneNote的专用VSTO项目类型
• 尝试使用IRibbonExtensibility并通过COM（regasm）注册DLL，但未成功
• 官方文档推荐的JavaScript方案针对OneNote Online，不符合仅聚焦OneNote Desktop的需求
• 找到的唯一相关示例代码已过时（约2010年）

问题 #

是否可以使用C#的“胖客户端”方案为OneNote Desktop创建此类扩展？

解答 #

可以实现，以下是两种可行的C#胖客户端方案：

方案1：OneNote COM API + 独立WinForms/WPF应用 + 自定义协议 #

• 添加自定义功能区按钮：编写符合Office RibbonX规范的UI XML文件，部署到OneNote的自定义UI目录并注册，按钮点击时触发自定义协议（如myonenoteext://trigger）。
• 开发独立应用：创建C# WinForms/WPF项目，监听自定义协议请求。收到请求后，通过Microsoft.Office.Interop.OneNote COM API读取当前笔记本的选中或全部内容。
• 数据处理与提交：在应用UI中收集额外输入，调用外部Web服务完成数据发送。
• 部署要点：注册自定义协议确保OneNote能唤起应用；使用对应M365版本的Interop库，避免版本兼容问题。

方案2：手动创建OneNote COM加载项 #

虽然无官方VSTO模板，但可手动构建COM加载项：

• 创建类库项目：新建C#类库，引用Microsoft.Office.Core和Microsoft.Office.Interop.OneNote，实现IRibbonExtensibility接口定义自定义功能区。
• 注册加载项：开启项目的“为COM互操作注册”选项，用regasm /codebase 你的DLL路径命令（管理员权限）注册，同时在注册表HKEY_CURRENT_USER\Software\Microsoft\Office\OneNote\Addins\你的加载项类名下添加必要条目（如LoadBehavior设为3）。
• 实现功能逻辑：在按钮点击事件中，以STA线程启动WinForms/WPF窗口，通过OneNote COM API获取当前内容，收集用户输入后调用Web服务。
• 排坑提示：旧示例失效多因OneNote COM接口变更，需对照M365 2410版本的对象模型调整代码；确保.NET Framework版本（建议4.7.2+）与OneNote兼容。

核心注意事项 #

• 两种方案均依赖OneNote COM API读取内容，需注意异步调用避免阻塞OneNote主线程。
• 自定义功能区XML需严格遵循RibbonX规范，确保按钮事件正确绑定。
• M365桌面版OneNote仍支持COM加载项，当前版本可稳定使用，无需局限于官方推荐的JavaScript方案。

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