如何在OfficeJS中获取多区域NamedItem的范围？

当使用NamedItem.getRange()处理包含不连续区域的命名范围时，会触发"This operation is not permitted for the current object"错误——因为该方法仅支持单区域的命名范围。要获取多区域命名范围的各个子区域，可以通过以下步骤实现：

1. 使用NamedItem.getRangeOrNullObject()替代getRange()，避免直接抛出错误
2. 访问返回Range对象的areas属性，该属性会返回包含所有不连续子区域的RangeAreas集合
3. 遍历RangeAreas集合，逐个获取并处理每个子区域

代码示例 #

async function retrieveMultiAreaNamedRange() {
  await Excel.run(async (context) => {
    // 替换为你的多区域命名范围名称
    const targetNamedItem = context.workbook.names.getItem("MultiAreaRange");
    // 获取命名范围对应的Range对象（避免报错）
    const range = targetNamedItem.getRangeOrNullObject();
    await context.sync();

    if (!range.isNullObject) {
      // 加载所有子区域
      const rangeAreas = range.areas;
      rangeAreas.load("items");
      await context.sync();

      // 遍历并处理每个子区域
      rangeAreas.items.forEach((subRange, index) => {
        subRange.load("address");
        return context.sync().then(() => {
          console.log(`子区域 ${index + 1} 地址：${subRange.address}`);
          // 在这里添加对子区域的具体操作逻辑
        });
      });
    } else {
      console.log("未找到指定的命名范围");
    }
  });
}

关键说明 #

• getRangeOrNullObject()：与getRange()不同，当命名范围为多区域时，该方法不会抛出错误，而是返回一个有效的Range对象，其areas属性可访问所有子区域
• RangeAreas：代表一组不连续的区域集合，通过items属性可获取每个子区域的Range实例，进而对单个区域进行读写、格式设置等操作

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