如何在Excel Office Script中获取表格自动筛选后的区域？

在Office Script中，无需手动遍历所有记录来获取筛选后的表格区域，原生API提供了直接获取可见区域的方法：

核心方法：getVisibleView() #

针对表格的数据体区域（即排除表头的部分），调用getVisibleView()即可直接获取筛选后的可见行范围。示例代码如下：

function main(workbook: ExcelScript.Workbook) {
  // 获取目标表格
  const targetTable = workbook.getTable("table1");
  // 获取表格的数据体区域（不含表头）
  const dataBodyRange = targetTable.getDataBodyRange();
  
  if (!dataBodyRange) {
    console.log("表格无数据行");
    return;
  }

  // 获取筛选后的可见区域
  const filteredVisibleRange = dataBodyRange.getVisibleView();
  // 获取筛选后区域的所有值
  const filteredValues = filteredVisibleRange.getValues();
  
  // 可根据需求对筛选后的数据进行后续操作
  console.log("筛选后的数据：", filteredValues);
}

多列筛选场景的使用 #

如果需要先对多列设置筛选条件，再获取结果，可以结合列筛选API和getVisibleView()，示例如下：

function main(workbook: ExcelScript.Workbook) {
  const targetTable = workbook.getTable("table1");
  
  // 对第一列设置值筛选
  targetTable.getColumn(0).getFilter().applyValuesFilter(["待筛选值1", "待筛选值2"]);
  // 对第二列设置文本包含筛选
  targetTable.getColumn(1).getFilter().applyContainsFilter("关键词");
  
  // 获取多列筛选后的可见区域
  const filteredRange = targetTable.getDataBodyRange()?.getVisibleView();
  if (filteredRange) {
    console.log("多列筛选后的数据：", filteredRange.getValues());
  }
}

补充说明 #

getVisibleView()方法会自动识别表格当前的筛选状态，返回仅包含可见行的Range对象，效率远高于手动遍历判断。之前未找到方案可能是对Office Script的Range API细节不熟悉，这是官方提供的标准实现，不存在设计复杂或bug问题。

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