Freigeben über

Office.TableData class

  • Referenz
Paket:
office

Stellt die Daten in einer Tabelle oder einer Office.TableBinding dar.

Konstruktoren

(constructor)(rows, headers)

Erstellt eine neue Instanz der TableData -Klasse
(constructor)()

Erstellt eine neue Instanz der TableData -Klasse

Eigenschaften

headers

Ruft die Kopfzeilen der Tabelle ab oder legt sie fest.
rows

Ruft die Zeilen in einer Tabelle ab oder legt diese fest. Gibt ein Array von Arrays zurück, das die Daten in der Tabelle enthält. Gibt ein leeres Array zurück, wenn keine Zeilen vorhanden sind.

Details zum Konstruktor

(constructor)(rows, headers)

Erstellt eine neue Instanz der TableData -Klasse

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

Parameter

rows

any[][]

headers

any[]

(constructor)()

Erstellt eine neue Instanz der TableData -Klasse

constructor();

Details zur Eigenschaft

headers

Ruft die Kopfzeilen der Tabelle ab oder legt sie fest.

headers: any[];

Eigenschaftswert

any[]

Hinweise

Zum Festlegen von Kopfzeilen müssen Sie ein Array aus Arrays festlegen, das der Tabellenstruktur entspricht. Wenn Sie z. B. Header für eine zweispaltige Tabelle angeben möchten, legen Sie die header-Eigenschaft auf [['header1', 'header2']]fest.

Wenn Sie null für die headers-Eigenschaft angeben (oder die Eigenschaft leer lassen, wenn Sie ein TableData-Objekt erstellen), treten die folgenden Ergebnisse auf, wenn Ihr Code ausgeführt wird.

  • Beim Einfügen einer neuen Tabelle werden die Standardkopfzeilen erstellt.

  • Beim Überschreiben oder Aktualisieren einer vorhandenen Tabelle bleiben die vorhandenen Kopfzeilen unverändert.

Beispiele

// 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

Ruft die Zeilen in einer Tabelle ab oder legt diese fest. Gibt ein Array von Arrays zurück, das die Daten in der Tabelle enthält. Gibt ein leeres Array zurück, wenn keine Zeilen vorhanden sind.

rows: any[][];

Eigenschaftswert

any[][]

Hinweise

Um Zeilen abzugeben, müssen Sie ein Array von Arrays angeben, das der Struktur der Tabelle entspricht. Wenn Sie beispielsweise zwei Zeilen mit Zeichenfolgenwerten in einer zweispaltigen Tabelle angeben möchten, legen Sie die rows-Eigenschaft auf [['a', 'b'], ['c', 'd']]fest.

Wenn Sie null für die rows-Eigenschaft angeben (oder die Eigenschaft leer lassen, wenn Sie ein TableData-Objekt erstellen), treten die folgenden Ergebnisse auf, wenn Ihr Code ausgeführt wird.

  • Beim Einfügen einer neuen Tabelle wird eine leere Zeile eingefügt.

  • Beim Überschreiben oder Aktualisieren einer vorhandenen Tabelle werden die vorhandenen Zeilen nicht geändert.

Beispiele

// 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;
}