Обновление OLE-объекта в листе Excel — руководство по API Aspose.Cells Cloud
Этот REST API обновляет OLE-объект в листе Excel.
Безопасность и аутентификация
API Aspose.Cells Cloud являются защищёнными и требуют аутентификации по токену JWT.
API PostUpdateWorksheetOleObject
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects/{oleObjectIndex}
Параметры запроса:
| Имя параметра | Тип | Местоположение параметра | Описание |
|---|---|---|---|
| name | string | path | Имя рабочей книги. |
| sheetName | string | path | Имя листа. |
| oleObjectIndex | integer | path | Индекс OLE-объекта в листе. |
| ole | object | body | JSON-представление обновляемого OLE-объекта. |
| folder | string | query | Папка, содержащая рабочую книгу. |
| storageName | string | query | Имя сервиса хранения. |
Поля тела запроса
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| 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 Specification определяет общедоступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать командную утилиту cURL для простого доступа к веб-сервисам Aspose.Cells. Пример ниже демонстрирует вызов облачного API с помощью cURL.
Ответы об ошибках
| HTTP-статус | Код | Сообщение |
|---|---|---|
| 400 | 4000 | Неверный запрос — отсутствующие или некорректные параметры. |
| 401 | 4010 | Неавторизованный доступ — некорректный или отсутствующий токен JWT. |
| 404 | 4040 | Не найдено — рабочая книга, лист или OLE-объект не существует. |
| 500 | 5000 | Внутренняя ошибка сервера — непредвиденная ошибка на стороне сервера. |
API также возвращает пользовательское поле Code в теле ответа, сопоставленное с HTTP-статусом (например, 200 → 2000, 400 → 4000 и т.д.).
Когда использовать этот API?
Используйте этот конечный пункт, если вам нужно изменить существующий OLE-объект — например, встроенное изображение, диаграмму или документ — без повторной загрузки всего листа. Типичные сценарии включают обновление источника изображения, изменение размера объекта или изменение его позиции после генерации рабочей книги. См. также: Добавление OLE-объекта и Удаление OLE-объекта.
Семейство облачных SDK
Использование SDK — самый быстрый способ разработки. SDK абстрагирует низкоуровневые детали, позволяя сосредоточиться на проекте. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Ниже приведён краткий пример на C#, демонстрирующий обновление OLE-объекта с помощью SDK Aspose.Cells Cloud:
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}");
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: