Worksheet:UsedRange

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

先决条件

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

HTTP 请求

POST /workbook/worksheets(<id|name>)/UsedRange

请求标头

名称 说明
Authorization Bearer

请求正文

在请求正文中,提供具有以下参数的 JSON 对象。

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

响应

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

示例

下面是一个如何调用此 API 的示例。

请求

下面是一个请求示例。

POST https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets(<id|name>)/UsedRange
Content-type: application/json
Content-length: 24

{
  "valuesOnly": true
}
响应

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

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"
}