Class NamedRange

NamedRange

Benannte Bereiche in einer Tabelle erstellen, aufrufen und ändern Benannte Bereiche sind Bereiche, die mit String-Aliassen verknüpft sind. Sie können sie über die Google Tabellen-UI im Menü Daten gt; Benannte Bereiche... aufrufen und bearbeiten.

Methoden

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

Detaillierte Dokumentation

getName()

Ruft den Namen dieses benannten Bereichs ab.

Zurücksenden

String: der Name dieses benannten Bereichs

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

---

getRange()

Ruft den Bereich ab, auf den durch diesen benannten Bereich verwiesen wird.

Zurücksenden

Range: Der Tabellenbereich, der diesem benannten Bereich zugeordnet ist.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

• 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.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

---

setName(name)

Legt den Namen des benannten Bereichs fest.

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

Parameter

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

Zurücksenden

NamedRange: Bereich, dessen Name vom Aufruf festgelegt wurde

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

---

setRange(range)

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

Parameter

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

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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