在 Excel 工作表中设置范围值 – Aspose.Cells Cloud API

使用此 REST API 在指定范围内设置值。在适当情况下,该值将被转换为其他数据类型,并重置单元格的数字格式。

前提条件

  • 有效的 Aspose Cloud 账户。
  • 包含 Cells.ReadWrite 权限范围的 JWT 令牌。
  • 工作簿必须已上传至目标存储位置。

PostWorksheetCellsRangeValue API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value

请求参数如下:

参数名称 类型 位置 描述
name string path 工作簿名称
sheetName string path 工作表名称
value string query 输入值
range object body 工作表中的范围对象
isConverted boolean query 指示是否应转换输入值
setStyle boolean query 指示是否将样式应用于目标单元格
folder string query 工作簿所在文件夹
storageName string query 存储名称

可在请求体中发送的 range 对象示例

{
  "range": {
    "FirstRow": 0,
    "FirstColumn": 0,
    "RowCount": 1,
    "ColumnCount": 1
  }
}

OpenAPI 规范 定义了一个公开可用的编程接口,可让您直接通过网页浏览器执行 REST 交互。

您可以使用 cURL 命令行工具轻松访问 Aspose.Cells 网络服务。以下示例展示了如何使用 cURL 调用云 API。请在 Authorization 请求头中包含有效的 JWT 令牌

响应架构

字段 类型 描述
Code integer 操作的 HTTP 状态码
Status string 结果的简短描述(例如:“OK”)
Message string 请求失败时的详细错误消息(可选)
Result object 成功调用时返回的额外数据(可选)

可能的 HTTP 状态码

  • 200 OK – 范围值已成功设置。
  • 400 Bad Request – 参数无效或请求体格式错误。
  • 401 Unauthorized – 缺少或无效的 JWT 令牌。
  • 403 Forbidden – 对所请求的操作权限不足。
  • 404 Not Found – 指定的工作簿、工作表或范围不存在。
  • 500 Internal Server Error – 意外服务器错误。

400 Bad Request 的示例错误响应:

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "范围对象 'range' 缺少必需字段。"
}

云 SDK 家族

使用 SDK 是加速开发的最佳方式。SDK 处理底层细节,使您能够专注于项目任务。请查阅 GitHub 仓库,获取 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用不同 SDK 调用 Aspose.Cells 网络服务: