Получение стиля ячейки из рабочего листа с помощью Aspose.Cells Cloud API – Подробное руководство

Используйте этот REST API для получения стиля ячейки в рабочем листе Excel.

GetWorksheetCellStyle API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/{cellName}/style

Безопасность и аутентификация

Aspose.Cells Cloud API защищены и требуют аутентификации на основе JWT-токена.

Параметры запроса

Имя параметра Тип Расположение Описание
name string path Имя документа Excel.
sheetName string path Имя рабочего листа.
cellName string path Адрес ячейки (например, A1).
folder string query Папка, содержащая файл.
storageName string query Имя хранилища, которое следует использовать.

Ответ

{
  "Style": {
    "Font": {
      "Color": { "A": 255, "R": 5, "G": 99, "B": 193 },
      "DoubleSize": 11,
      "IsBold": false,
      "IsItalic": false,
      "IsStrikeout": false,
      "IsSubscript": false,
      "IsSuperscript": false,
      "Name": "Calibri",
      "Size": 11,
      "Underline": "Single"
    },
    "Name": null,
    "CultureCustom": "General",
    "Custom": "",
    "BackgroundColor": { "A": 0, "R": 0, "G": 0, "B": 0 },
    "ForegroundColor": { "A": 0, "R": 0, "G": 0, "B": 0 },
    "IsFormulaHidden": false,
    "IsDateTime": false,
    "IsTextWrapped": false,
    "IsGradient": false,
    "IsLocked": true,
    "IsPercent": false,
    "ShrinkToFit": false,
    "IndentLevel": 0,
    "Number": 0,
    "RotationAngle": 0,
    "Pattern": "None",
    "TextDirection": "Context",
    "VerticalAlignment": "Bottom",
    "HorizontalAlignment": "General",
    "BorderCollection": [
      {
        "LineStyle": "None",
        "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
        "BorderType": "BottomBorder"
      },
      {
        "LineStyle": "None",
        "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
        "BorderType": "DiagonalDown"
      },
      {
        "LineStyle": "None",
        "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
        "BorderType": "DiagonalUp"
      },
      {
        "LineStyle": "None",
        "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
        "BorderType": "Horizontal"
      },
      {
        "LineStyle": "None",
        "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
        "BorderType": "LeftBorder"
      },
      {
        "LineStyle": "None",
        "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
        "BorderType": "RightBorder"
      },
      {
        "LineStyle": "None",
        "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
        "BorderType": "TopBorder"
      },
      {
        "LineStyle": "None",
        "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
        "BorderType": "Vertical"
      }
    ],
    "BackgroundThemeColor": null,
    "ForegroundThemeColor": null,
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/a1/style",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Коды HTTP-статуса

Код Значение Описание
200 OK (ОК) Фильтр успешно применён; ответ содержит сведения об операции.
400 Bad Request (Неверный запрос) Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401 Unauthorized (Неавторизовано) Недействительный или отсутствующий JWT-токен.
413 Payload Too Large (Слишком большой полезный груз) Загруженный файл превышает предельный размер.
500 Internal Server Error (Внутренняя ошибка сервера) Непредвиденная ошибка сервера.

Ответы с ошибками
Типичные полезные нагрузки ошибок для этой конечной точки следуют стандартному формату ошибок Aspose.Cells. Например, при коде 400 (Bad Request) возвращается:

{
  "Code": 400,
  "Message": "Недопустимый параметр 'cellName'.",
  "Description": "Указанное имя ячейки не соответствует допустимому формату A1."
}

Аналогично, при коде 401 (Unauthorized) возвращается:

{
  "Code": 401,
  "Message": "Ошибка аутентификации.",
  "Description": "JWT-токен отсутствует или недействителен."
}

Как использовать API GetWorksheetCellStyle с SDK

Спецификация API GetWorksheetCellStyle

Спецификация OpenAPI определяет общедоступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Пример ниже показывает, как выполнить вызов облачного API с помощью cURL.

Схема ответа

Поле Тип Описание
Style object Контейнер всех свойств, относящихся к стилю ячейки.
Style.Font object Параметры шрифта (имя, размер, цвет, флаги стиля).
Style.Font.Color object RGBA-значения цвета шрифта.
Style.Font.IsBold boolean true, если шрифт жирный.
Style.Font.IsItalic boolean true, если шрифт курсивный.
Style.Font.IsStrikeout boolean true, если шрифт зачеркнут.
Style.Font.IsSubscript boolean true, если шрифт нижний индекс.
Style.Font.IsSuperscript boolean true, если шрифт верхний индекс.
Style.Font.Name string Название семейства шрифтов (например, Calibri).
Style.Font.Size number Размер шрифта в пунктах.
Style.Font.Underline string Стиль подчёркивания (например, Single).
Style.IsLocked boolean Указывает, защищена ли ячейка от редактирования.
Style.IsTextWrapped boolean true, если включено перенос текста по строкам.
Style.IsGradient boolean true, если применён градиентный залив.
Style.Pattern string Название паттерна заливки (например, None).
Style.BorderCollection array Список объектов границ, определяющих стиль линии, цвет и тип границы.
Style.BackgroundColor object RGBA-значения цвета фона ячейки.
Style.ForegroundColor object RGBA-значения цвета переднего плана ячейки.
… … (Остальные поля следуют той же структуре, что указана в справке API.)

Использование SDK Aspose.Cells Cloud

Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя вам сосредоточиться на задачах вашего проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.

Следующие примеры кода показывают, как вызывать веб-сервисы Aspose.Cells с помощью различных SDK:

См. также

Обновление стиля нескольких ячеек – Справочник по API Aspose.Cells Cloud (v3.0)