如何通过Microsoft Graph判断Excel指定区域内的合并单元格？

要通过Microsoft Graph识别SharePoint上Excel文档指定区域内的合并单元格，可通过以下两种方式实现：

1. 批量获取单元格的mergedCell属性 #

直接查询目标区域的单元格信息，指定返回mergedCell字段——该字段标记单元格是否为合并区域的左上角起始单元格：

• 针对普通区域的请求示例：

  GET sites/{site-id}/drive/items/{item-id}/workbook/worksheets/{sheet-name}/range(address='A1:C5')?$select=cellAddress,mergedCell
  

• 针对命名区域的请求示例：

  GET sites/{site-id}/drive/items/{item-id}/workbook/names/{named-range}/range?$select=cellAddress,mergedCell
  

返回结果中，mergedCell值为true的单元格就是某个合并区域的起始点，其余被合并的单元格该值为false。

2. 调用getMergedRange方法确认合并范围 #

如果需要确认单个单元格是否属于合并区域，以及获取完整的合并范围，可以对目标单元格发送POST请求调用getMergedRange方法：

POST sites/{site-id}/drive/items/{item-id}/workbook/worksheets/{sheet-name}/range(address='B2')/getMergedRange

• 若该单元格属于合并区域，返回结果会包含整个合并区域的地址（如A1:C1）；
• 若不是合并单元格，返回结果就是该单元格自身的地址。

批量排查合并区域的流程 #

如果要遍历整个指定区域的所有合并单元格，可按以下步骤操作：

• 第一步：用方法1的请求获取区域内所有单元格的mergedCell状态；
• 第二步：筛选出mergedCell: true的起始单元格；
• 第三步：对每个起始单元格调用getMergedRange，得到完整的合并区域范围，以此整理出指定区域内所有合并单元格的分布。

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