Excel桌面端onNameChanged事件失效问题求助

核心原因 #

worksheetCollection.onNameChanged事件目前仅在Excel网页版（Office 365）正式可用，你使用的桌面版Excel版本16.0.14326.21170属于Semi-Annual Enterprise Channel（半年企业通道），该版本未包含此功能，因此触发AccessDenied错误。

解决步骤 #

1. 升级桌面版Excel版本
   需将Excel升级到Monthly Channel（月度通道）16.0.15427及以上，或Current Channel（当前通道）对应版本，这些通道会优先推送新的API功能。

2. 检查Add-in清单配置
   确保你的Office插件清单文件（manifest.xml）中，声明了对ExcelApi 1.15及以上版本的依赖，因为onNameChanged是ExcelApi 1.15引入的功能：

   <Requirements>
     <Sets DefaultMinVersion="1.15">
       <Set Name="ExcelApi" MinVersion="1.15"/>
     </Sets>
   </Requirements>
   

3. 优化事件处理代码
   事件对象已直接提供nameBefore和nameAfter属性，无需额外调用context.sync()，简化后的代码如下：

   export const onSheetNameChange = (event) => {
     const { nameAfter, nameBefore } = event;
     if (nameBefore !== nameAfter) {
       console.log('nameBefore=>', nameBefore);
       console.log('nameAfter=>', nameAfter);
     }
   };
   
   export const onSheetRenameHandler = () => {
     Excel.run(async (context) => {
       const sheets = context.workbook.worksheets;
       sheets.onNameChanged.add(onSheetNameChange);
       await context.sync();
       console.log('工作表重命名事件处理器已注册');
     }).catch(error => {
       console.error(error);
     });
   };
   

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