如何使用Office.js从Excel的RangeAreas（不连续单元格）中取值？

RangeAreas本质是多个连续Range对象的集合，无法直接像单个Range那样获取values属性，需要遍历其包含的每个子Range来分别获取值，具体实现步骤如下：

1. 加载RangeAreas的areas属性，该属性会返回所有组成这个不连续区域的单个Range对象集合。
2. 遍历每个子Range，加载它们的values属性（若需要地址也可同时加载address）。
3. 执行context.sync()后，逐个提取每个子Range的数值。

完整代码示例：

let currentWorksheet = context.workbook.worksheets.getActiveWorksheet();
let foundRangeAreas = currentWorksheet.findAll("My Keyword", { completeMatch: false, matchCase: false });

// 加载RangeAreas的areas集合，以及每个area的values和address
foundRangeAreas.load("areas/values, areas/address");

return context.sync().then(function () {
    // 遍历所有子Range
    for (let i = 0; i < foundRangeAreas.areas.length; i++) {
        let range = foundRangeAreas.areas[i];
        console.log(`区域 ${range.address} 的值：`, JSON.stringify(range.values));
    }
});

关键说明 #

• foundRangeAreas.load("areas/values, areas/address")：使用深度加载语法，一次性加载所有子Range的values和address属性，避免多次调用context.sync()。
• 遍历foundRangeAreas.areas时，每个元素都是标准的Range对象，拥有和单个连续Range相同的属性和方法，因此可以直接访问values获取单元格值。

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