Diese Seite wurde von der Cloud Translation API übersetzt.

Class 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