通过

更新区域

  • 项目

命名空间：microsoft.graph

更新 range 对象的属性。

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

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

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 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。
Workbook-Session-Id 确定是否保留更改的工作簿会话 ID。 可选。

请求正文

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

属性 类型 说明
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 对象。

示例

请求

以下示例显示了一个请求。 该示例更新区域 - 值、数字格式和公式。 输入是为了指示 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"
}