计算单元格公式 – Aspose.Cells Cloud API 文档

REST API

此 REST API 用于计算 Excel 工作簿中的单元格公式。

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

安全与身份验证

Aspose.Cells Cloud API 采用安全机制，需使用基于 JWT 令牌的身份验证。

请求参数

参数名称	类型	参数位置（路径/查询/请求体）	描述
name	string	path	Excel 文件名称（例如：`Book1.xlsx`）。
sheetName	string	path	包含目标单元格的工作表名称。
cellName	string	path	待计算单元格的地址（例如：`A1`）。
options	object	body	包含计算选项的 JSON 对象（详见 Options 对象表格）。
folder	string	query	文件在存储中的文件夹路径。
storageName	string	query	Aspose Cloud 存储空间的名称。

Options 对象

字段	类型	描述	默认值
CalcStackSize	string	最大计算堆栈大小。	`"1"`
IgnoreError	boolean	若为 `true`，忽略计算错误，并将单元格值设为 `#N/A`。	`false`
Recursive	boolean	启用对依赖单元格的递归计算。	`false`
Precision	string	数值结果的小数位数。	`"15"`
UseThreading	boolean	启用多线程计算。	`false`

响应

{
    "Status":"OK",
    "Code":200
}

HTTP 状态码

状态码	含义	描述
200	OK（成功）	筛选器应用成功；响应包含操作详情。
400	Bad Request（错误请求）	缺少或参数无效（例如：不支持的文件类型）。
401	Unauthorized（未授权）	JWT 令牌无效或缺失。
413	Payload Too Large（请求实体过大）	上传文件超出大小限制。
500	Internal Server Error（内部服务器错误）	服务器发生意外错误。

如何结合 SDK 使用 PostCellCalculate API

PostCellCalculate API 规范

OpenAPI 规范定义了一个公开可访问的编程接口，允许您直接从 Web 浏览器发起 REST 交互。

您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例演示了如何通过 cURL 调用 Cloud API。首先需通过 /connect/token 端点完成身份验证以获取 JWT 令牌，然后将 <jwt token> 替换为实际的令牌值。

请求

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/cells/A1/calculate" \
  -d '{"CalcStackSize":"1"}' \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

响应

{
  "Code": 200,
  "Status": "OK"
}

使用 Aspose.Cells Cloud SDK

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

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

在 Excel 工作表中设置单元格公式清除 Excel 工作表中的单元格格式