prependRow

function prependRow(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  values: unknown,
  options: PrependRowsOptions | null | undefined = {}
): GoogleAppsScript.Spreadsheet.Sheet;

prependRows mit einer einzigen Zeile: zuerst wird Platz geschaffen, sodass nichts Vorhandenes überschrieben wird. Ein Blatt bekommt die Zeile ganz oben; ein Bereich unmittelbar über seiner ersten Zeile, wobei die Werte auf den Spalten des Bereichs landen.

Eine Zelle, deren Text mit = beginnt, wird als Formel geschrieben, nicht als Text — dieselbe Regel wie im Editor.

Parameter

Parameter	Typ	Beschreibung
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Das Blatt, in das eingefügt wird, oder der Bereich, an dem eingefügt wird.
`values`	`unknown`	Eine einzelne Zeile: ein flaches Array, ein Wert je Spalte.
`options` (optional) `= {}`	`PrependRowsOptions \\| null \\| undefined`	`afterFrozenRows` fügt unter den fixierten Zeilen ein statt ganz oben. Ein Bereich bestimmt die Stelle selbst, dort bewirkt die Option nichts.

Rückgabewert

GoogleAppsScript.Spreadsheet.Sheet — das Blatt, sodass Aufrufe verkettet werden können.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	kein Argument übergeben wurde.
`InvalidSheetException`	das erste Argument weder ein Blatt noch ein Bereich ist.
`TypeError`	die Werte kein flaches Array sind.

Beispiele

Am Anfang eines Blatts einfügen

const sheet = SpreadsheetApp.getActiveSheet();

prependRow(sheet, ["Name", "Email"]);

An einem Bereich einfügen

const sheet = SpreadsheetApp.getActiveSheet();

prependRow(sheet.getRange("B4:C13"), ["Name", "Email"]);

Siehe auch

Quellcode

src/appsscript/sheet/prependRow.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.