Class DataTableBuilder

DataTableBuilder

Builder von DataTable-Objekten. Beim Erstellen einer Datentabelle werden zuerst die Spalten angegeben und die Zeilen werden nacheinander hinzugefügt. Beispiel:

var data = Charts.newDataTable()
    .addColumn(Charts.ColumnType.STRING, "Month")
    .addColumn(Charts.ColumnType.NUMBER, "In Store")
    .addColumn(Charts.ColumnType.NUMBER, "Online")
    .addRow(["January", 10, 1])
    .addRow(["February", 12, 1])
    .addRow(["March", 20, 2])
    .addRow(["April", 25, 3])
    .addRow(["May", 30, 4])
    .build();

Methoden

MethodeRückgabetypKurzbeschreibung
addColumn(type, label)DataTableBuilderFügt der Datentabelle eine Spalte hinzu.
addRow(values)DataTableBuilderFügt der Datentabelle eine Zeile hinzu.
build()DataTableErstellt eine Datentabelle und gibt sie zurück.
setValue(row, column, value)DataTableBuilderLegt einen bestimmten Wert in der Tabelle fest.

Detaillierte Dokumentation

addColumn(type, label)

Fügt der Datentabelle eine Spalte hinzu. Es werden Spalten von 0 bis n hinzugefügt.

Die erste Spalte wird häufig von Diagrammen für Beschriftungen verwendet (z. B. Labels der X-Achse in Liniendiagrammen oder Segmentbeschriftungen in Kreisdiagrammen). Die anderen Spalten werden häufig für Daten verwendet und erfordern daher oft numerische Werte.

Parameter

NameTypBeschreibung
typeColumnTypeDatentyp in der Spalte (Zahl, String oder Datum)
labelStringBeschriftung der Spalte, die für Diagrammlegenden verwendet wird.

Return

DataTableBuilder: Dieser Builder zum Verketten.


addRow(values)

Fügt der Datentabelle eine Zeile hinzu.

Parameter

NameTypBeschreibung
valuesObject[]Werte für die Zeile, die in der Reihenfolge angegeben werden, in der die Spalten eingegeben werden.

Return

DataTableBuilder: Dieser Builder zum Verketten.


build()

Erstellt eine Datentabelle und gibt sie zurück.

Return

DataTable – die Datentabelle

Löst aus

Error: Wenn die Datentabelle leer oder anderweitig fehlerhaft ist


setValue(row, column, value)

Legt einen bestimmten Wert in der Tabelle fest.

Sie können einen Wert festlegen, bevor Sie die Spalte zur Datentabelle hinzufügen. Wenn die Spalte jedoch nicht irgendwann hinzugefügt wird, wird der Wert ignoriert.

Nicht alle Spaltenwerte müssen ausgefüllt werden. Die fehlenden werden als null eingestuft.

Parameter

NameTypBeschreibung
rowIntegerZeilenindex (die erste Zeile hat Index 0)
columnIntegerSpaltenindex (die erste Spalte hat Index 0)
valueObjectden Wert der Tabellenzelle (sollte den richtigen Typ für die Spalte haben)

Return

DataTableBuilder – dieser Builder zum Verketten