使用 Aspose.Cells Cloud API 向 Excel 工作表添加空列

此 REST API 可向工作表中插入一列或多列。

前提条件
调用此接口前，请确保已完成以下步骤：

获取有效的 OAuth 2.0 访问令牌，并将其包含在 Authorization 请求头中。
将目标工作簿存储在所选存储中（默认为 “Default”），或指定适当的 folder 和 storageName 参数。
确认 sheetName 参数中提供的工作表名称存在于工作簿中。

PutInsertWorksheetColumns API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/{columnIndex}?totalColumns=1

安全与身份验证

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

请求参数

参数名	类型	位置	描述
name	string	路径	工作簿文件名。
sheetName	string	路径	工作表名称。
columnIndex	integer	路径	插入起始列的从零开始的索引。
totalColumns	integer	查询	要插入的列数。
updateReference	boolean	查询	若为 true，单元格引用将更新以反映插入操作。
folder	string	查询	包含工作簿的文件夹路径。
storageName	string	查询	存储服务名称。

说明

columnIndex 必须介于 0 与工作表当前列数之间；超出现有范围插入将自动扩展工作表。
插入多列（totalColumns > 1）会将现有列向右移动。
updateReference 标志默认为 false；若需更新公式与命名区域，请设置为 true。

OpenAPI 规范定义了一个公开可访问的编程接口，您可直接在 Web 浏览器中进行 REST 交互。

您可使用 cURL 命令行工具调用 Aspose.Cells Web 服务。以下示例展示了一个完整的请求，包括身份验证与正确的路径参数。

请求

curl -X PUT "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/1?totalColumns=1&updateReference=true" \
     -H "Authorization: Bearer <access_token>" \
     -H "accept: application/json"

响应

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

响应码

状态码	描述
200	列插入成功。
400	请求错误 — 缺少或无效的参数。
401	未授权 — 令牌无效或缺失。
404	工作簿或工作表未找到。
500	服务器内部错误。

示例错误响应

// 400 请求错误 — 缺少或无效的参数
{
  "Code": 400,
  "Message": "无效参数：totalColumns 必须为正整数。"
}

// 401 未授权 — 令牌无效或缺失
{
  "Code": 401,
  "Message": "身份验证失败。访问令牌缺失或无效。"
}

// 404 未找到 — 工作簿或工作表不存在
{
  "Code": 404,
  "Message": "未找到工作簿 'test.xlsx'。"
}

// 500 服务器内部错误
{
  "Code": 500,
  "Message": "服务器上发生意外错误。"
}

云 SDK 家族

使用 SDK 是最快捷的开发方式。SDK 处理底层细节，让您专注于项目逻辑。请查看 GitHub 仓库获取 Aspose.Cells Cloud SDK 的完整列表。

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

C#

Java

PHP

Ruby

Node.js

Python

Perl

Go

在 Excel 工作表中复制列