Worksheet:UsedRange

使用的区域是包含分配了值或格式化的任何单元格的最小区域。如果工作表为空,此函数将返回左上角的单元格。

先决条件

要执行此 API,需要以下范围

* Files.ReadWrite

HTTP 请求

GET /workbook/worksheets/{id|name}/UsedRange

可选的请求参数

在请求 URL 中,提供可选的查询参数。

参数 类型 说明
valuesOnly Boolean 可选。仅将有值的单元格视为已使用的单元格(忽略格式)。

请求头

名称 说明
Authorization Bearer {code}

响应

如果成功,此方法在响应正文中返回 200, OK 响应代码和 Range 对象。

示例

下面的示例展示了如何调用此 API。

请求

下面是一个请求示例。

GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{id|name}/UsedRange(valuesOnly=true)
Content-type: application/json

响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 169

{
  "address": "address-value",
  "addressLocal": "addressLocal-value",
  "cellCount": 99,
  "columnCount": 99,
  "columnIndex": 99,
  "valueTypes": "valueTypes-value"
}