有没有更简单的方法来实现缺少的“getNamedRange(....)”方法？

Question

在 Google Apps 脚本中，电子表格和表格上有一个方法 getNamedRanges()，它返回命名范围的列表。但是没有返回 SINGLE 命名范围的 getNamedRange("Name")。

我觉得这很奇怪。

为了解决这个问题，我使用了这个复杂的过程：

function testing()
{
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var nameOfNamedRange = "NameOfMyNamedRange";

  var namedRanges = ss.getNamedRanges();

  /* ###### THIS IS WHAT I HAVE TO DO ######### */
  for (i = 0; i<namedRanges.length; ++i)
  { var nRange = namedRanges[i];
    if ( nRange.getName() == nameOfNamedRange )
      {
        /* Process nRange
        doSomething(nRange);
        */
        Logger.log(nRange.getName());
      }
  }

/* ############ THIS IS WHAT I'D LIKE TO DO (or something similar) ##########
    var nRange = ss.getNamedRange("NameOfMyNamedRange") // ...Range   not ...Ranges

*/
}

有没有更简单的方法来做到这一点？我忍不住想我错过了一些明显的东西。

Answer 1

比如用getRangeByName()的方法怎么样？

修改脚本：

var ss = SpreadsheetApp.getActiveSpreadsheet();
var nameOfNamedRange = "NameOfMyNamedRange";
var nRange = ss.getRangeByName(nameOfNamedRange); // Added

参考：

• getRangeByName()

编辑：

当您想检索单个命名范围时，下面的示例脚本怎么样，因为没有直接检索单个命名范围的方法？命名范围的名称在电子表格中只有一个。这个可以用。请认为这只是几个答案之一。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var nameOfNamedRange = "NameOfMyNamedRange";
var nRange = ss.getNamedRanges().filter(function(e) {return e.getName() === nameOfNamedRange})[0]; // Added

Answer 2

不幸的是，没有返回单个 NamedRange 实例的函数。但是您可以清理当前的解决方法并将其包装成一个实用函数，如下所示：

(function(scope){
    const Utils = scope.Utils || (scope.Utils = {});

    /**
     * Filter function
     */
    function filterByName(namedRange) {
        return this.name === namedRange.getName();
    }

    /**
     * Gets named range by name.
     *
     * @param {Spreadsheet|Sheet} context - An instance of Spreadsheet or Sheet.
     * @param {String}               name - The name of a NamedRange.
     *
     * @return {NamedRange} A NamedRange or null if not found.
     */
    function getNamedRangeByName(context, name) {
        if (!context || !context.getNamedRanges) {
            throw new Error("Invalid context object; must implement getNamedRanges()");
        }

        var filtered = context.getNamedRanges().filter(filterByName.bind({name:name}));

        return filtered.length ? filtered[0] : null;
    }

    Utils.getNamedRangeByName = getNamedRangeByName;
})(this);

只需将上面的脚本添加到你的项目中，然后调用如下：

var ss = SpreadsheetApp.getActive();
var nameOfNamedRange = "[NAME_OF_NAMED_RANGE]";

var namedRange = Utils.getNamedRangeByName(ss, nameOfNamedRange);

Answer 3

实际上有一种方法可以获取命名范围。假设我有一个名为“Test”的命名范围 A1:B3。

var values = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1").getRange("Test").getValues();

将返回 A1:B3 中的值。或者更简单。

  var values = SpreadsheetApp.getActiveSpreadsheet().getRange("Test").getValues();

如果目标是更改名称，试试这个。

var spread = SpreadsheetApp.getActiveSpreadsheet();
var range = spread.getRange("Test");
spread.setNamedRange("Other",range);