Поделиться через


Office.TableData class

Представляет данные в таблице или 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[]

Комментарии

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

Если задать значение NULL для свойства headers (или оставить свойство пустым при создании объекта 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']].

Если указать значение NULL для свойства rows (или оставить свойство пустым при создании объекта 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;
}