Aspose.Cells Cloud – 将 Excel 范围转换为 HTML
Contents
[
Hide
]
通过 Aspose.Cells Cloud 直接将本地 Excel 工作簿中的选定范围转换为 HTML 文件。转换操作完全在云端服务器上执行，因此您无需上传整个工作簿，也无需在本地安装 Excel。
将范围转换为 HTML 的 API
PUT https://api.aspose.cloud/v4.0/cells/convert/range/html
请求体为 multipart/form-data 格式，包含电子表格文件；其余选项通过查询参数传递。
安全与身份验证
Aspose.Cells Cloud API 采用安全机制，需使用 基于 JWT 令牌的身份验证。
请求参数
| 名称 | 类型 | 位置 | 是否必填 | 描述 |
|---|---|---|---|---|
| Spreadsheet | 文件 | FormData | 是 | 待转换的 Excel 工作簿。 |
| worksheet | 字符串 | 查询参数 | 是 | 包含目标范围的工作表名称。 |
| range | 字符串 | 查询参数 | 是 | 待转换的单元格区域，例如 A1:C10。 |
| outPath | 字符串 | 查询参数 | 否 | 输出 HTML 文件的存储路径（默认为 null）。 |
| outStorageName | 字符串 | 查询参数 | 否 | 输出文件所使用的存储服务名称。 |
| fontsLocation | 字符串 | 查询参数 | 否 | 自定义字体文件夹路径。 |
| AutoRowsFit | 布尔值 | 查询参数 | 否 | 自动调整工作表中所有行高。 |
| AutoColumnsFit | 布尔值 | 查询参数 | 否 | 自动调整工作表中所有列宽。 |
| region | 字符串 | 查询参数 | 否 | 区域标识符（例如 zh-CN、en-US、fr-FR），影响数字/日期格式化。 |
| password | 字符串 | 查询参数 | 否 | 打开受保护工作簿所需的密码。 |
| fontsLocation | 字符串 | 查询参数 | 否 | 自定义字体位置。 |
| region | 字符串 | 查询参数 | 否 | 电子表格区域/语言设置。 |
| password | 字符串 | 查询参数 | 否 | 打开电子表格文件所需的密码。 |
响应
API 将返回转换后的 HTML 文件，格式为二进制流（application/octet-stream）。
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
成功响应示例（HTTP）
HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="report.html"
Content-Length: 8423
<table>
<tr><th>Product</th><th>Price</th></tr>
<tr><td>Widget A</td><td>$10</td></tr>
<tr><td>Widget B</td><td>$15</td></tr>
</table>
将响应体保存为文件（例如 report.html），即可在浏览器中查看渲染后的表格。
HTTP 状态码
| 状态码 | 含义 | 描述 |
|---|---|---|
| 200 | OK（成功） | 范围筛选成功；响应体包含操作详情。 |
| 400 | Bad Request（请求错误） | 缺失或无效参数（例如不支持的文件类型）。 |
| 401 | Unauthorized（未授权） | JWT 令牌无效或缺失。 |
| 413 | Payload Too Large（载荷过大） | 上传文件超出大小限制。 |
| 500 | Internal Server Error（内部服务器错误） | 服务器发生意外错误。 |
如何结合 SDK 使用“将范围转换为 HTML”API？
OpenAPI 规范
OpenAPI 规范 提供了公开可访问的 API 接口定义，可直接通过网页浏览器发起 REST 请求。
您可使用 cURL 命令行工具轻松调用 Aspose.Cells 云服务。以下示例展示了如何使用 cURL 调用云 API。
使用 Aspose.Cells Cloud SDK
使用 SDK 是最快捷的开发方式，它屏蔽了底层细节，使您能以最少代码实现将数据范围转换为 HTML 文件。
请参阅我们在 GitHub 仓库 中提供的完整 SDK 列表。
以下代码示例展示了如何使用不同 SDK 调用 Aspose.Cells 云服务。若无法从 Gist 加载示例，可直接从仓库下载。