对 Excel 工作表中的范围数据进行排序

REST API 可对 Excel 工作表中指定范围内的数据进行排序。

REST API

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

请求参数

参数名称 类型 位置 必填 描述
name string 路径 是 工作簿名称。
sheetName string 路径 是 工作表名称。
cellArea string 查询 是 要排序的单元格范围（例如 A5:A10）。
dataSorter object 请求体 是 定义排序设置的 JSON 对象（见下方架构）。
folder string 查询 否 包含该工作簿的文件夹。
storageName string 查询 否 工作簿所在的存储名称。

dataSorter 对象架构 —— 请求体必须包含一个具有以下属性的 JSON 对象：

  • CaseSensitive (布尔值，必需) —— 指定排序是否区分大小写。
  • HasHeaders (布尔值，必需) —— 指定该范围是否包含标题行。
  • KeyList (数组，必需) —— 排序键的集合。每个键对象包括：
    • Key (整数) —— 从零开始的列索引。
    • SortOrder (字符串) —— "ascending"（升序）或 "descending"（降序）。
  • SortLeftToRight (布尔值，必需) —— 若为 true，则按从左到右的方式排序；否则按从上到下排序。
  • 其他可选字段（如 CaseOrder、SortLeftToRight 等）可依据 OpenAPI 规范提供。

OpenAPI 规范 定义了一个公开可访问的编程接口，允许您直接通过网页浏览器执行 REST 交互。

您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何通过 cURL 调用云 API。

错误处理 —— API 可返回标准 HTTP 错误码。常见响应包括：

HTTP 状态码 代码 消息
400 400 请求错误 —— 缺少或无效的参数。
401 401 未授权 —— JWT 令牌无效或缺失。
404 404 未找到 —— 工作簿或工作表不存在。
500 500 服务器内部错误。

错误情况下，响应体遵循格式：{ "Code": <状态码>, "Message": "<描述>", "Status": "Error" }。

云 SDK 家族

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

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