тип ресурса workbookTable
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Представляет таблицу Excel.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Список | Коллекция workbookTable | Получение коллекции объектов table. |
| Add | workbookTable | Создание таблицы. Исходный адрес диапазона определяет лист, на который будет добавлена таблица. Если не удается добавить таблицу (например, потому, что адрес недопустим или таблица перекрывается другой таблицей), возникает ошибка. |
| Получение | workbookTable | Чтение свойств и связей объекта workbookTable. |
| Обновление | workbookTable | Обновите объект workbookTable. |
| удаление; | Нет | Удаляет таблицу. |
| Перечисление столбцов | коллекция workbookTableColumn | Получение списка объектов workbookTableColumn. |
| Создание столбца | workbookTableColumn | Создайте новый файл workbookTableColumn, опубликовав его в коллекции столбцов. |
| Список строк | коллекция workbookTableRow | Получение коллекции объектов workbookTableRow. |
| Создание строки | workbookTableRow | Создайте новый файл workbookTableRow, опубликовав его в коллекции строк. |
| Получение диапазона текста данных | workbookRange | Возвращает объект workbookRange, связанный с телом данных таблицы. |
| Получение диапазона строк заголовка | workbookRange | Возвращает объект workbookRange, связанный со строкой заголовка таблицы. |
| Получение диапазона таблицы | workbookRange | Возвращает объект workbookRange, связанный со всей таблицей. |
| Получение общего диапазона строк | workbookRange | Возвращает объект workbookRange, связанный со строкой итогов таблицы. |
| Очистка фильтров | Нет | Удаляет все фильтры, примененные к таблице. |
| Преобразование в диапазон | workbookRange | Преобразовывает таблицу в обычный диапазон ячеек. Все данные сохраняются. |
| Повторное применение фильтров | Нет | Повторно применяет все текущие фильтры к таблице. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| id | string | Уникальный идентификатор таблицы в книге. Значение идентификатора остается прежним, даже если переименовать таблицу. Это свойство должно быть интерпретировано как непрозрачное строковое значение и не должно быть проанализировано ни с каким другим типом. Только для чтения. |
| name | string | Имя таблицы. |
| showHeaders | Логический | Указывает, отображается ли строка заголовков. Можно задать это значение, чтобы отобразить или скрыть строку заголовков. |
| showTotals | Логический | Указывает, отображается ли строка итогов. Можно задать это значение, чтобы отобразить или скрыть строку итогов. |
| style | string | Значение константы, представляющее стиль таблицы. Возможные значения: TableStyleLight1 через TableStyleLight21, TableStyleMedium1 через TableStyleMedium28, TableStyleStyleDark1 через TableStyleStyleDark11. Также можно указать настраиваемый пользовательский стиль, имеющийся в книге. |
| highlightFirstColumn | Boolean | Указывает, содержит ли первый столбец специальное форматирование. |
| highlightLastColumn | Boolean | Указывает, содержит ли последний столбец специальное форматирование. |
| showBandedColumns | Boolean | Указывает, чередуется ли форматирование четных и нечетных столбцов для более удобного просмотра таблицы. |
| showBandedRows | Boolean | Указывает, чередуется ли форматирование четных и нечетных строк для более удобного просмотра таблицы. |
| showFilterButton | Boolean | Указывает, видны ли кнопки фильтрации в верхней части заголовков столбцов. Это свойство можно использовать, только если таблица содержит строку заголовков. |
| legacyId | String | Устаревший идентификатор, используемый в старых клиентах Excel. Значение идентификатора остается прежним, даже если переименовать таблицу. Это свойство должно быть интерпретировано как непрозрачное строковое значение и не должно быть проанализировано ни с каким другим типом. Только для чтения. |
Связи
| Связь | Тип | Описание |
|---|---|---|
| columns | коллекция workbookTableColumn | Список всех столбцов в таблице. Только для чтения. |
| rows | коллекция workbookTableRow | Список всех строк в таблице. Только для чтения. |
| sort | workbookTableSort | Сортировка для таблицы. Только для чтения. |
| лист | workbookWorksheet | Лист, содержащий текущую таблицу. Только для чтения. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"highlightFirstColumn": true,
"highlightLastColumn": true,
"id": "String (identifier)",
"name": "String",
"showBandedColumns": true,
"showBandedRows": true,
"showFilterButton": true,
"showHeaders": true,
"showTotals": true,
"style": "String",
"legacyId": "String"
}