反馈 编辑

更新区域

  • 项目

命名空间：microsoft.graph

更新 range 对象的属性。

Permissions

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Files.ReadWrite
委派（个人 Microsoft 帐户） 不支持。
应用程序 不支持。

HTTP 请求

PATCH /me/drive/items/{id}/workbook/names/{name}/range
PATCH /me/drive/root:/{item-path}:/workbook/names/{name}/range
PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>')
PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')
PATCH /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range
PATCH /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range

可选的请求标头

名称 说明
Authorization Bearer {token}。必需。
Workbook-Session-Id 确定是否保留更改的工作簿会话 ID。可选。

请求正文

在请求正文中，提供应更新的相关字段的值。请求正文中不包括的现有属性将保留其以前的值，或根据对其他属性值的更改重新计算。为了获得最佳性能，不应包括尚未更改的现有值。

属性 类型 Description
columnHidden boolean 表示当前区域中的所有列是否隐藏。
formulas Json 表示采用 A1 表示法的公式。
formulasLocal Json 表示采用 A1 样式表示法的公式，使用用户的语言和数字格式区域设置。例如，英语中的公式 "=SUM(A1, 1.5)" 在德语中将变为 "=SUMME(A1; 1,5)"。
formulasR1C1 Json 表示采用 R1C1 样式表示法的公式。
numberFormat Json 表示 Excel 中指定单元格的数字格式代码。
rowHidden boolean 表示当前区域中的所有行是否隐藏。
values Json 表示指定区域的原始值。返回的数据类型可能是字符串、数字或布尔值。包含一个将返回错误字符串的错误的单元格。

响应

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

示例

请求

下面是一个请求示例。该示例更新区域 - 值、数字格式和公式。null 输入是为了指示 API 忽略单元格的特定输入。值、数字格式和公式可以独立更新，也可以在同一 API 调用中共同更新。

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{sheet-id}/range(address='A1:B2')
Content-type: application/json

{
"values" : [["Hello", "100"],["1/1/2016", null]],
"formulas" : [[null, null], [null, "=B1*2"]],
"numberFormat" : [[null,null], ["m-ddd", null]]
}
响应

这是一个示例响应。注意：为提高可读性，可能缩短了此处显示的响应对象。

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

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