excel - 为什么这个 Context.Sync 不起作用？

Question

为什么除非我取消注释 range.values=range.values 行，否则此代码段不会将值写回 Excel？

$('#run').click(function() {
    invokeRun()
        .catch(OfficeHelpers.logError);
});
function invokeRun() {
    return Excel.run(function(context) {
        var range = context.workbook.worksheets.getItem("Sheet1").getRange("A1:B3");
        range.load('values');
        return context.sync()
            .then(function() {
               range.values[1][1]=99;
               console.log(JSON.stringify(range.values));
                //range.values=range.values
                return context.sync();
        });
    });
}

Answer 1

数组属性很特殊。我在我的网站上添加了一个页面来描述该主题: Reading and writing array properties .

从那里总结，代理对象模型的工作方式，每当您在对象上设置属性时，Office.js 运行时都有一个 Hook 到 setter 和 getter，用于拦截调用并将命令添加到队列。

我们先举一个普通属性的例子。根据上述，每当您设置类似 range.format.fill.color = "red" , color 属性的 setter 拦截请求并在内部添加一个命令到队列中以将范围填充颜色设置为红色(与下一个 context.sync 一起调度)

另一方面，如果你只有 var color = range.format.fill.color(当然，在 load 和 sync 之后)，getter 将代替 setter 触发，并且颜色变量将获得范围的当前填充颜色。

现在，那是常规属性。每当您设置数组的元素时，您实际上是在将数组值作为 getter 访问。从运行时的角度来看，这一行与稍微冗长的版本没有什么不同:

var array = range.values;
array[r][c] = '-';

因为 range.values 的 setter/getter 返回一个完全普通的 JS 数组对象，访问它然后设置它的值不会将它传播回原始 Range 对象。

如果您希望值得到反射(reflect)，最好的办法是在同步后立即获取对数组的引用(即 var array = range.values，如上所述)，然后根据需要设置数组上的值，然后最后将其设置回对象: range.values = array .

这意味着您还可以就地修改 values 数组，然后在循环完成时将 values 属性分配回自身( range.values = range.values )。然而，这看起来很尴尬，好像它是一个空操作，而实际上并非如此。所以就个人而言，我更喜欢在开始时检索数组并将其分配给自己的变量，然后进行任何必要的修改，最后将整个数组设置回来。

更新以澄清上述内容:

很清楚，通过访问 .values 返回的数组, .formulas等， 是 纯 Vanilla JS 数组。这实际上是问题的症结所在:为了让 Office.js 返回纯对象，这意味着这些纯对象不能“添加”以反射(reflect)变化的能力。

值得一提的是，我们实际上有一个即将推出的功能，应该在一两个月内推出，我们将在其中引入 object.set语法，如:

range.set({
   values: [[1, 2], [3, 4]],
   format: {
       fill: {
           color: "purple"
       }
   }
}

这将使在同一个对象上设置多个属性更方便，但也可能使数组属性更易于处理。