Class NamedRange

NamedRange

Benannte Bereiche in einer Tabelle erstellen, darauf zugreifen und ändern. Benannte Bereiche sind Bereiche, die zugehörige String-Aliasse. Sie können sie in der Benutzeroberfläche von Google Tabellen unter Daten > Benannte Bereiche... aus.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getName()	String	Ruft den Namen dieses benannten Bereichs ab.
getRange()	Range	Ruft den Bereich ab, auf den von diesem benannten Bereich verwiesen wird.
remove()	void	Löscht diesen benannten Bereich.
setName(name)	NamedRange	Legt den Namen des benannten Bereichs fest bzw. aktualisiert ihn.
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.

Rückflug

String – Der Name dieses 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 von diesem benannten Bereich verwiesen wird.

Rückflug

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 bzw. 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.

Rückflug

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 Tabellenbereich, der mit diesem benannten Bereich verknüpft werden soll.

Rückflug

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