Office.TableData class

Пакет:
office

Представляет данные в таблице или Office.TableBinding.

Комментарии

Используется

Конструкторы

(constructor)(rows, headers)

Создает новый экземпляр TableData класса
(constructor)()

Создает новый экземпляр TableData класса

Свойства

headers

Получает или задает заголовки таблицы.
rows

Получает или задает строки в таблице. Возвращает массив массивов, который содержит данные в таблице. Возвращает пустой массив, если строк нет.

Сведения о конструкторе

(constructor)(rows, headers)

Создает новый экземпляр TableData класса

constructor(rows: any[][], headers: any[]);

Параметры

rows

any[][]

headers

any[]

(constructor)()

Создает новый экземпляр TableData класса

constructor();

Сведения о свойстве

headers

Получает или задает заголовки таблицы.

headers: any[];

Значение свойства

any[]

Комментарии

Чтобы указать заголовки, задайте массив массивов, соответствующий структуре таблицы. Например, чтобы задать заголовки для таблицы с двумя столбцами, нужно задать свойству заголовка значение [['заголовок1', 'заголовок2']].

Если для свойства headers задано значение null (или оно оставлено пустым при создании объекта TableData), при выполнении кода будут получены следующие результаты.

  • При вставке новой таблицы будут созданы заголовки столбцов по умолчанию.

  • При перезаписи или обновлении существующей таблицы существующие заголовки не изменятся.

Примеры

// The following example creates a single-column table with a header and three rows.
function createTableData() {
    const tableData = new Office.TableData();
    tableData.headers = [['header1']];
    tableData.rows = [['row1'], ['row2'], ['row3']];
    return tableData;
}

rows

Получает или задает строки в таблице. Возвращает массив массивов, который содержит данные в таблице. Возвращает пустой массив, если строк нет.

rows: any[][];

Значение свойства

any[][]

Комментарии

Чтобы задать строки, необходимо указать массив массивов, соответствующий структуре таблицы. Например, чтобы указать две строки строковых значений в таблице с двумя столбцами, необходимо присвоить свойству rows значение [['a', 'b'], ['c', 'd']].

Если для свойства rows задано значение null (или это свойство остается пустым при создании объекта TableData), при выполнении кода возникают следующие результаты.

  • При вставке новой таблицы будет вставлена пустая строка.

  • При перезаписи или обновлении существующей таблицы существующие строки не изменятся.

Примеры

// The following example creates a single-column table with a header and three rows.
function createTableData() {
    const tableData = new Office.TableData();
    tableData.headers = [['header1']];
    tableData.rows = [['row1'], ['row2'], ['row3']];
    return tableData;
}