c# - Word 加载项中的绑定(bind)用法

Question

我想使用 Office 插件技术为 Word 文档提供模型- View - Controller 逻辑。

在我的场景中，用户应该能够创建一个新的 Word 文档，激活加载项并按下加载项内的按钮以将文本框字段添加到文档中。该字段应显示来自数据库的数字:当用户更新该数字并按保存时，该数字应写回数据库。下次打开 Word 文档时，应刷新数字，以显示更新后的值。

我想知道的是插件技术是否可以使用(也许支持绑定(bind)？)还是处于试验阶段。我在尝试理解构建仅代表我的文本框的紧凑型 OOXML 的最佳方法时遇到了麻烦:方法 getSelectedDataAsync 输出一个非常复杂的文档，它不是描述单光基本差的更聪明的方法-裸文本框字段!以及如何将绑定(bind)设置为自定义 XML？该 XML 应该放在哪里？文件里面？我查看了 Microsoft 在 GitHub 上提供的示例，但它们不是很清楚，因为在许多情况下它们基于现有的 Word 文档，这些文档已经具有必要的数据和字段。

Answer 1

当然!您描述的场景实际上是该平台最初设计的主要加载项类型之一。关键元素是一个 JavaScript 对象，我们称之为“绑定(bind)”，它跟踪文档中的内容控件，并且不需要 OXML 或自定义 XML。

API 能够直接添加内容控件(类似于文本框):调用 Bindings.addFromSelectionAsync方法。

function addNewField(fieldName){
    Office.context.document.bindings.addFromSelectionAsync("text",
    { id: fieldName },
    function (asyncResult){
        displayNumberFromDatabase(asyncResult.value);
    }
}

还有 register for two event handlers这样当用户选择或修改这些内容控件中的文本时您会收到通知。本例中的相关事件是BindingSelectionChanged和 BindingDataChanged , 分别。

Office.context.document.addHandlerAsync("bindingDataChanged", whenBindingDataChanged);
Office.context.document.addHandlerAsync("bindingSelectionChanged", whenBindingSelected);

当这些事件被触发时，您会想要阅读内容。你可以用 Binding.getDataAsync 做到这一点方法。

function whenBindingDataChanged(eventArgs){
    eventArgs.binding.getDataAsync(function(asyncResult){
        setValueToDatabaseAsync(eventArgs.binding.id,asyncResult.value);
        // you need to implement setValueToDatabaseAsync
    });
}

最后，要自己修改Binding的内容写入初始值，使用Binding.setDataAsync方法。

function displayNumberFromDatabase(myBinding){
    getValueFromDatabaseAsync(myBinding.id, function(value){
        myBinding.setDataAsync(value);
    });
    // you need to implement getValueFromDatabaseAsync
}

-Michael Saunders，Office 插件项目经理