Class NamedRange

NamedRange

Benannte Bereiche in einer Tabelle erstellen, aufrufen und ändern Benannte Bereiche sind Bereiche mit zugehörigen Stringaliassen. Sie können in der Benutzeroberfläche von Google Tabellen im Menü Daten > Benannte Bereiche... aufgerufen und bearbeitet werden.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getName()	String	Ruft den Namen des benannten Bereichs ab.
getRange()	Range	Ruft den Bereich ab, auf den in diesem benannten Bereich verwiesen wird.
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 bzw. aktualisiert ihn.

Detaillierte Dokumentation

getName()

Ruft den Namen des benannten Bereichs ab.

Return

String – der Name des benannten Bereichs

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

getRange()

Ruft den Bereich ab, auf den in diesem benannten Bereich verwiesen wird.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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.
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.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 bzw. aktualisiert ihn.

Parameter

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

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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