Class NamedRange

BenannterBereich

Benannte Bereiche in einer Tabelle erstellen, auf sie zugreifen und sie ändern Benannte Bereiche sind Bereiche, die Stringaliasse haben. Sie können über die Google Tabellen-Benutzeroberfläche im Menü Daten > Namensbereiche aufgerufen und bearbeitet werden.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getName()	String	Ruft den Namen dieses benannten Bereichs ab.
getRange()	Range	Ruft den Bereich ab, auf den dieser benannte Bereich verweist.
remove()	void	Löscht diesen benannten Bereich.
setName(name)	NamedRange	Legt den Namen des benannten Bereichs fest oder aktualisiert ihn.
setRange(range)	NamedRange	Legt den Bereich für diesen benannten Bereich fest oder aktualisiert ihn.

Detaillierte Dokumentation

getName()

Ruft den Namen dieses benannten Bereichs ab.

Rückflug

String: der Name dieses benannten Bereichs

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getRange()

Ruft den Bereich ab, auf den dieser benannte Bereich verweist.

Rückflug

Range: der Tabellenbereich, der mit diesem benannten Bereich verknüpft ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

remove()

Löscht diesen benannten Bereich.

// The code below deletes all the named ranges in the spreadsheet.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setName(name)

Legt den Namen des benannten Bereichs fest oder aktualisiert ihn.

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

Parameter

Name	Typ	Beschreibung
name	String	Der neue Name des benannten Bereichs.

Rückflug

NamedRange: der Bereich, dessen Name durch den Aufruf festgelegt wurde

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setRange(range)

Legt den Bereich für diesen benannten Bereich fest oder aktualisiert ihn.

Parameter

Name	Typ	Beschreibung
range	Range	Der Tabellenbereich, der mit diesem benannten Bereich verknüpft werden soll.

Rückflug

NamedRange: der benannte Bereich, für den der Tabellenbereich festgelegt wurde

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets