Установка значения ячейки – Справочник по API Aspose.Cells Cloud (v3.0)
Этот REST API позволяет установить значение ячейки в файле Excel.
REST API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/{cellName}
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе токена JWT.
Параметры запроса
| Имя | Тип | Местоположение | Описание |
|---|---|---|---|
| name | string | path | Имя документа Excel (включая расширение). |
| sheetName | string | path | Имя рабочего листа (с учетом регистра). |
| cellName | string | path | Адрес целевой ячейки в формате A1 (например, A1). |
| value | string | query | Значение, присваиваемое ячейке. |
| type | string | query | Тип данных значения (int, string, float и т.д.). |
| formula | string | query | Формула, применяемая к ячейке (необязательно). |
| folder | string | query | Папка, содержащая документ (необязательно). |
| storageName | string | query | Имя хранилища, в котором находится файл (необязательно). |
Ответ
Возвращает объект CellResponse.
- Обзор полей ответа
| Поле | Тип | Описание |
|---|---|---|
Name |
string | Адрес ячейки (например, F341). |
Row |
integer | Индекс строки (начиная с 0). |
Column |
integer | Индекс столбца (начиная с 0). |
Value |
string | Отображаемое значение ячейки. |
Type |
string | Тип данных ячейки (например, IsString). |
Formula |
string | Текст формулы, если ячейка содержит формулу. |
IsFormula |
bool | Указывает, содержит ли ячейка формулу. |
IsMerged |
bool | Указывает, является ли ячейка частью объединённого диапазона. |
IsArrayHeader |
bool | Указывает, является ли ячейка заголовком массива. |
IsInArray |
bool | Указывает, принадлежит ли ячейка массиву. |
IsErrorValue |
bool | Указывает, содержит ли ячейка ошибочное значение. |
IsInTable |
bool | Указывает, находится ли ячейка внутри таблицы. |
IsStyleSet |
bool | Указывает, применён ли к ячейке стиль. |
HtmlString |
string | HTML-представление значения ячейки. |
Style.link |
object | Ссылка на ресурс стиля. |
{
"Status":"OK",
"Code":200,
"Cell":{
"Name":"A1",
"Row": 0,
"Column":0,
"Value": "",
"Type":"String",
"Formula" : "=Sum(A2:A15)",
...
}
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизован) | Недействительный или отсутствующий токен JWT. |
| 413 | Payload Too Large (Слишком большой payload) | Загружаемый файл превышает допустимый размер. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API PostWorksheetCellSetValue с SDK
Спецификация API PostWorksheetCellSetValue
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание, позволяющее разработчикам напрямую вызывать REST-эндпоинты из браузера или любого HTTP-клиента.
Вы можете использовать утилиту командной строки cURL для вызова веб-сервисов Aspose.Cells. Пример ниже демонстрирует, как установить значение ячейки с помощью cURL.
Использование SDK Aspose.Cells Cloud
Использование SDK ускоряет разработку, скрывая низкоуровневые детали, что позволяет сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Примеры кода ниже демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK: