通过

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

 

发布日期： 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 方法处理共享变量。

getContext

返回 客户端上下文（客户端引用） 对象的方法

ExecutionContextObj.getContext()
  • 返回值
    类型： 对象

getDepth

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

  • 返回值
    类型： 数字

    订单从 0 开始。

getEventArgs

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

备注

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

ExecutionContextObj.getEventArgs()

getEventSource

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

ExecutionContextObj.getEventSource()

  • 返回值
    类型： 对象

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

共享变量：

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

setSharedVariable

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

ExecutionContextObj.setSharedVariable(key, value)

  • 参数
    String：变量的名称

    Object：要设置的值。

getSharedVariable

检索使用 setSharedVariable 的变量集。

ExecutionContextObj.getSharedVariable(key)

  • 参数
    String：变量的名称。

  • 返回值
    类型： 对象

    特定类型取决于对象的值。

另请参阅

客户端编程引用

© 2017 Microsoft。 保留所有权利。 版权