执行上下文（客户端引用）

发布日期： 2016年11月

适用于： Dynamics CRM 2015

执行上下文中是一个能够通过事件处理程序传递到 JavaScript 库函数的可选参数。当您指定函数名称时，此选项出现在处理程序属性对话中。这个是使用 passExecutionContext 属性对 <Handler> (FormXml) 元素进行设置的选项。

执行上下文会使用 Xrm.Page.data.addOnSave、Xrm.Page.data.entityAttribute.addOnChange 和 Xrm.Page.uiControl.addPreSearch 方法自动传递到函数集。

执行上下文方法

getContext
返回客户端上下文（客户端引用）对象的方法。
getDepth
返回一个指示此处理程序的执行顺序的值的方法。
getEventArgs
使用管理 Save 事件的方法返回对象的方法。
getEventSource
返回对发生事件的对象的引用的方法。
共享变量：
共享变量允许与同一事件的其他处理程序共享变量。您使用 setSharedVariable 和 getSharedVariable 方法处理共享变量。

ExecutionContextObj.getContext()

返回一个指示此处理程序的执行顺序的值的方法。

使用管理 Save 事件的方法返回对象的方法。

备注

除 Save 事件外，此方法将对其他所有事件返回 null。

ExecutionContextObj.getEventArgs()

返回对发生事件的对象的引用的方法。

ExecutionContextObj.getEventSource()

返回值
类型： 对象

此方法返回事件来源的 Xrm.Page 对象模型的对象，而不是 HTMLDOM 对象。例如，在 OnChange 事件中，该方法会返回表示更改属性的 Xrm.Page.data.entity 属性对象。

共享变量允许与同一事件的其他处理程序共享变量。使用 setSharedVariable 和 getSharedVariable 方法可在函数之间传递变量。

在当前处理程序完成后，设置可由处理程序使用的变量值。

ExecutionContextObj.setSharedVariable(key, value)

检索使用 setSharedVariable 的变量集。

ExecutionContextObj.getSharedVariable(key)