使用 Aspose.Cells Cloud API 将列表对象转换为区域

此 REST API 可将 Excel 工作表中的 ListObject（表格） 转换为 区域（Range）。

前置条件：
调用端点前，请确保：

工作簿已上传至您的 Aspose Cloud 存储空间；
工作表中包含目标 ListObject；
使用受支持的文件格式（例如 .xlsx、.xlsm）。

REST API

身份验证
调用此操作时，必须在 Authorization 请求头中包含有效的 JWT 令牌。您可通过向 OAuth 2.0 令牌端点发送 POST 请求（附带您的客户端 ID 和客户端密钥）来获取该令牌。该令牌必须包含 Cells.ReadWrite 作用域，并在令牌服务返回的有效期内有效。

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/ConvertToRange

安全与身份验证

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

请求参数

参数名称	类型	位置	是否必填	默认值	描述
name	string	路径	是	–	Excel 文件的名称。
sheetName	string	路径	是	–	包含 ListObject 的工作表名称。
listObjectIndex	integer	路径	是	–	待转换 ListObject（表格）的从零开始索引。
folder	string	查询	否	–	文件所在文件夹的路径。
storageName	string	查询	否	–	存储服务的名称。

注意： 此操作仅适用于现代 Excel 格式，如 .xlsx 和 .xlsm。ListObject 不得受保护。有关 ListObjects 的更多信息，请参阅 ListObjects 概述；有关区域操作的详细说明，请参阅区域文档。

cURL 示例（请求）

请求

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects/0/ConvertToRange" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <your-jwt-token>"

响应

{
  "Code": 200,
  "Status": "OK",
  "RangeName": "A1:C10",
  "Address": "Sheet1!A1:C10",
  "FirstRow": 0,
  "FirstColumn": 0,
  "RowCount": 10,
  "ColumnCount": 3
}

云 SDK 开发工具包

使用 SDK 是加快开发速度的最佳方式。SDK 负责处理底层细节，使您能专注于项目核心任务。请查看 GitHub 仓库，了解 Aspose.Cells Cloud SDK 的完整列表。

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

更新 Excel 工作表中的列表对象对 Excel 工作表中的 ListObject 数据进行排序