批量替换本地 Excel 文件中的文本 – 查找与替换 API
Contents
[
Hide
]
无需上传至云端即可替换本地 Excel 电子表格文件中的指定文本。利用 Aspose.Cells Cloud 查找与替换 API 实现离线编辑，高效更新工作簿内容。
替换电子表格内容 API
Web API
PUT https://api.aspose.cloud/v4.0/cells/replace/content
安全性与身份验证
Aspose.Cells Cloud API 安全可靠，需要使用 基于 JWT 令牌的身份验证。
-H "Authorization: Bearer {access_token}"
请求参数：
| 参数名称 | 类型 | 路径/查询字符串/HTTP 请求体 | 描述 |
|---|---|---|---|
| Spreadsheet | 文件 | FormData | 待处理的本地电子表格文件。支持格式包括 XLSX、XLS、ODS、CSV 等。 |
| searchText | 字符串 | 查询字符串 | 要在指定工作表和单元格区域中查找的文本字符串。 |
| replaceText | 字符串 | 查询字符串 | 将替换指定范围内所有 searchText 出现位置的文本字符串。 |
| worksheet | 字符串 | 查询字符串 | （可选） 执行查找与替换操作的工作表名称。若省略，则操作应用于第一个工作表。 |
| cellArea | 字符串 | 查询字符串 | （可选） 指定的单元格范围（例如 "A1:D20"、"B5:F15"），在该范围内执行文本查找与替换。若省略，则操作应用于指定工作表中所有已用单元格。 |
| region | 字符串 | 查询字符串 | （可选） 设置文本处理的区域设置，可能影响查找操作中的大小写敏感性和字符编码（例如 "en-US"、"fr-FR"）。 |
| password | 字符串 | 查询字符串 | （可选） 若上传的电子表格受密码保护，请提供密码以打开并处理文件。 |
响应
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
]
响应为包含更新后工作簿的二进制流。请将其以适当的文件扩展名（例如 .xlsx）保存。
错误代码
- 400 Bad Request（错误请求） – Aspose.Cells Cloud API URI 无效或参数格式错误。
- 401 Unauthorized（未授权） – 访问令牌无效或缺失；请获取新的令牌。
- 404 Not Found（未找到） – 电子表格文件无法访问，或指定的工作表不存在。
- 500 Server Error（服务器错误） – 处理电子表格时发生内部错误；如问题持续存在，请联系技术支持。
替换电子表格内容 API 的适用场景
- 批量处理本地 Excel 文件 – 自动化处理存储在本地的多个工作簿中的查找与替换任务。
- 本地数据处理流程 – 将 API 集成至定期任务中，在报告归档或分发前对其进行修改。
- 本地报告生成 – 无需上传云端，即可向模板工作簿中动态插入值。
为何应使用替换电子表格内容 API？
- 开发者友好 – Aspose.Cells Cloud 提供多种编程语言的 SDK 库，支持快速开发并配有详尽文档；相比自研方案，可显著减少开发工作量。
- 降低人工成本 – 减少对专人执行手动文档整合的需求。
- 按需付费 – 无需前期投入，仅为您实际使用的 API 调用次数付费。
- 零维护成本 – 无需维护服务器、无需软件更新、无需担心兼容性问题。
- 保留复杂 Excel 格式 – 替换操作后，原始工作簿的格式、公式和图表均保持不变。
如何使用 SDK 调用替换电子表格内容 API
OpenAPI 规范
OpenAPI 规范 定义了公开可访问的编程接口，允许您直接从网页浏览器发起 REST 请求。
使用 Aspose.Cells Cloud SDK
使用 SDK 是加速开发的最快方式。SDK 负责处理底层细节，使您能够以最少代码实现替换内容操作。请参阅官方 Aspose.Cells Cloud SDK GitHub 仓库，了解支持的完整编程语言列表。
以下代码示例展示了如何通过多种 SDK 与 Aspose.Cells Web 服务进行交互：