使用 Aspose.Cells Cloud API 在 Excel 工作表中添加空行
Contents
[
Hide
]
此 REST API 可向 Excel 工作表添加新行,将空行插入到指定的从零开始的索引位置。
前提条件:
- 必须在
Authorization请求头中包含有效的 Aspose Cloud 访问令牌(Bearer JWT)。 - 目标工作簿必须已上传至您的 Aspose Cloud 存储空间,且
folder与storageName参数应指向其所在位置。
注意事项:
rowIndex为从零开始的索引;在索引 0 处插入将在工作表顶部添加一行。- Excel 工作表最多支持 1,048,576 行;若尝试超出此限制进行插入,将导致错误。
PutInsertWorksheetRow API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}
安全性与身份验证
Aspose.Cells Cloud API 安全可靠,需采用 基于 JWT 令牌的身份验证。
请求参数
| 参数名称 | 类型 | 位置 | 描述 |
|---|---|---|---|
| name | string | path | 工作簿文件名。 |
| sheetName | string | path | 工作表名称。 |
| rowIndex | integer | path | 新行将被插入的从零开始的索引位置。 |
| folder | string | query | 包含工作簿的存储空间路径。 |
| storageName | string | query | 要使用的 Aspose Cloud 存储空间名称。 |
OpenAPI 规范 定义了一个公开可访问的编程接口,允许您直接从网页浏览器执行 REST 交互。
您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何使用 cURL 调用 Cloud API。
HTTP 状态码
| 状态码 | 含义 | 描述 |
|---|---|---|
| 200 | OK(成功) | 筛选器应用成功;响应包含操作详情。 |
| 400 | Bad Request(错误请求) | 缺少或无效参数(例如不支持的文件类型)。 |
| 401 | Unauthorized(未授权) | 无效或缺失 JWT 令牌。 |
| 413 | Payload Too Large(请求实体过大) | 上传文件超过大小限制。 |
| 500 | Internal Server Error(内部服务器错误) | 服务器发生意外错误。 |
错误响应示例(例如,当行索引超出工作表限制时):
{
"Code": 400,
"Status": "Bad Request",
"Message": "行索引超出范围。允许的最大行数为:1048576。"
}
云 SDK 家族
使用 SDK 是加快开发速度的最佳方式。SDK 封装了底层细节,使您能专注于项目任务本身。请查阅 GitHub 仓库 获取 Aspose.Cells Cloud SDK 的完整列表。
以下代码示例展示了如何使用不同 SDK 调用 Aspose.Cells Web 服务: