使用执行上下文和窗体事件管道

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

此主题介绍如何使用窗体事件管道来管理事件的多个事件处理程序，以及如何使用执行上下文来对不同事件重新使用 JavaScript 库函数。

执行上下文

当您将 JavaScript 库中的函数与 Microsoft Dynamics 365 中的事件处理程序相关联时，可以选中“将执行上下文作为第一个参数传递”选项。下表列出执行上下文对象方法。

方法	说明
getContext	返回 Xrm.Page.context 对象。有关更多信息，请参阅客户端上下文（客户端引用）。
getDepth	返回一个指示此处理程序的执行顺序的值。
getEventSource	返回对发生事件的对象的引用。
getSharedVariable	检索使用 setSharedVariable 的变量集。
setSharedVariable	在当前处理程序完成后，设置可由处理程序使用的变量值。

在函数中使用 getEventSource 方法可使函数更通用。例如，如果您有一个设置电话号码格式的函数，则可以使用 getEventSource 方法来引用引发 onChange 事件的属性。您的函数无需引用特定属性。

您最多可以为每个事件定义 50 个处理程序。每个处理程序按窗体元素属性对话框的“事件”选项卡上的显示顺序执行。该顺序对应于事件的 <Handlers> (FormXml) 元素中的 <Handler> (FormXml) 元素的列表。

使用 setSharedVariable 和 getSharedVariable 方法可在函数之间传递通用变量。使用执行上下文 getDepth 方法可了解函数相对于其他处理程序的执行顺序。

Microsoft Dynamics 365