getNamedRangeByName

function getNamedRangeByName(
  spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet,
  name: string
): GoogleAppsScript.Spreadsheet.NamedRange | null;

Ein benannter Bereich ist der stabile Weg, auf einen Zellblock zu zeigen, den ein Mensch im Blatt verschieben kann. Apps Script liefert nur die ganze Liste, also werden die Namen durchlaufen und verglichen.

Ein nicht definierter Name ergibt null — der Fall, den man behandelt, wenn eine Vorlage von Hand bearbeitet wurde.

Parameter

Parameter	Typ	Beschreibung
`spreadsheet`	`GoogleAppsScript.Spreadsheet.Spreadsheet`	Die Tabelle, in der gesucht wird.
`name`	`string`	Der Name des Bereichs.

Rückgabewert

GoogleAppsScript.Spreadsheet.NamedRange | null — den benannten Bereich oder null, wenn es den Namen nicht gibt.

Beispiele

Nachschlagen

const spreadsheet = SpreadsheetApp.getActive();

const range = getNamedRangeByName(spreadsheet, "Settings");

range?.getRange().getValues();

Siehe auch

Quellcode

src/appsscript/sheet/getNamedRangeByName.ts

23 September 2026

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