Class NamedRange

AdlandırılmışAralık

E-tablolarda adlandırılmış aralıklar oluşturma, bunlara erişme ve bunları değiştirme Adlandırılmış aralıklar, ilişkili dize takma adları olan aralıklardır. Bunlar, E-Tablolar kullanıcı arayüzündeki Veriler > Adlandırılmış aralıklar... menüsünden görüntülenebilir ve düzenlenebilir.

Yöntemler

YöntemDönüş türüKısa açıklama
getName()StringBu adlandırılmış aralığın adını alır.
getRange()RangeBu adlandırılmış aralığın referans verdiği aralığı alır.
remove()voidBu adlandırılmış aralığı siler.
setName(name)NamedRangeAdlandırılmış aralığın adını ayarlar/günceller.
setRange(range)NamedRangeBu adlandırılmış aralığın aralığını ayarlar/günceller.

Ayrıntılı dokümanlar

getName()

Bu adlandırılmış aralığın adını alır.

Return

String: Bu adlandırılmış aralığın adı

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getRange()

Bu adlandırılmış aralığın referans verdiği aralığı alır.

Return

Range: Bu adlandırılmış aralıkla ilişkili e-tablo aralığı

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

remove()

Bu adlandırılmış aralığı siler. 

// 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();
}

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setName(name)

Adlandırılmış aralığın adını ayarlar/günceller. 

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

Parametreler

AdTürAçıklama
nameStringAdlandırılmış aralığın yeni adı.

Return

NamedRange: Adı çağrı tarafından belirlenen aralık

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setRange(range)

Bu adlandırılmış aralığın aralığını ayarlar/günceller.

Parametreler

AdTürAçıklama
rangeRangeBu adlandırılmış aralıkla ilişkilendirilecek e-tablo aralığı.

Return

NamedRange: E-tablo aralığının ayarlandığı adlandırılmış aralık

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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