更新 Excel 工作表中的 OLE 对象 – Aspose.Cells Cloud API 指南

此 REST API 用于更新 Excel 工作表中的 OLE 对象。

安全与认证

Aspose.Cells Cloud API 采用安全机制，需进行 基于 JWT 令牌的认证。

PostUpdateWorksheetOleObject API

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

请求参数如下：

参数名 类型 位置 描述
name string 路径 工作簿名称。
sheetName string 路径 工作表名称。
oleObjectIndex integer 路径 OLE 对象在工作表中的索引（从 0 开始）。
ole object 请求体 待更新的 OLE 对象的 JSON 表示。
folder string 查询 包含该工作簿的文件夹路径。
storageName string 查询 存储服务的名称。

请求体字段

字段名 类型 是否必需 描述
ImageSourceFullName string 可选 用于 OLE 对象的图像文件路径。
IsAutoSize boolean 可选 是否自动调整 OLE 对象大小。
SourceFullName string 必需 OLE 对象的源文件（如图像或图表）路径。
UpperLeftRow integer 必需 左上角单元格的行索引（从 0 开始）。
UpperLeftColumn integer 必需 左上角单元格的列索引（从 0 开始）。
Left integer 可选 距离左上角的水平偏移量（单位：磅）。
Top integer 可选 距离左上角的垂直偏移量（单位：磅）。
Width integer 必需 OLE 对象的宽度（单位：磅）。
Height integer 必需 OLE 对象的高度（单位：磅）。

OpenAPI 规范 定义了一个公开可用的编程接口，允许您直接从 Web 浏览器发起 REST 调用。

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

错误响应

HTTP 状态码 Code 消息
400 4000 错误请求 — 缺少或无效的参数。
401 4010 未授权 — 无效或缺失的 JWT 令牌。
404 4040 未找到 — 工作簿、工作表或 OLE 对象不存在。
500 5000 服务器内部错误 — 服务端发生意外故障。

API 还会在响应体中返回自定义的 Code 字段，与 HTTP 状态码对应（如：200 → 2000，400 → 4000 等）。

何时使用此 API？

当您需要修改已有的 OLE 对象（如嵌入的图像、图表或文档）而无需重新上传整个工作表时，请使用此接口。典型场景包括：更新图像源、调整对象大小或在工作簿生成后修改其位置。相关操作请参阅 添加 OLE 对象 和 删除 OLE 对象。

云 SDK 开发套件

使用 SDK 是最快捷的开发方式。SDK 封装了底层细节，让您专注于业务逻辑。请查阅 GitHub 仓库 获取 Aspose.Cells Cloud SDK 的完整列表。

以下是一个使用 Aspose.Cells Cloud SDK 更新 OLE 对象的 C# 示例：

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var config = new Configuration
{
    AppSid = "<your-app-sid>",
    AppKey = "<your-app-key>"
};
var oleApi = new OleObjectsApi(config);
var request = new OleObjectUpdateRequest
{
    ImageSourceFullName = "aspose-logo.png",
    IsAutoSize = true,
    SourceFullName = "Sample_Book2.xls",
    UpperLeftRow = 15,
    UpperLeftColumn = 5,
    Left = 10,
    Top = 10,
    Width = 400,
    Height = 400
};

var response = oleApi.UpdateWorksheetOleObject("SampleBook.xlsx", "Sheet1", 0, request, folder: "myFolder");
Console.WriteLine($"Status: {response.Status}");

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

在 Excel 工作表中添加 OLE 对象 将 OLE 对象转换为图像 – Aspose.Cells Cloud REST API