保存事件参数（客户端引用）

 

发布日期： 2017年1月

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

在保存事件中，您可以使用执行上下文对象 getEventArgs 方法来检索包含您可以用于管理保存事件方法的对象。

保存事件参数方法

• getSaveMode
  返回一个指示用户如何启用保存事件的值。

• isDefaultPrevented
  返回一个指示保存事件是否已取消的值，因为该事件处理程序或先前事件处理程序使用 preventDefault 方法。

• preventDefault
  取消保存操作，但是，将执行事件的所有其余处理程序。

getSaveMode

返回一个指示用户如何启用保存事件的值。

execObj.getEventArgs().getSaveMode()

• 返回值
  类型： 数字。

  下表描述返回的受支持的值（以不同方式检测实体记录）可以被用户保存。

  实体	事件模式	值
  所有	保存​​	1
  所有	保存并关闭	2
  所有	保存并新建	59
  所有	自动保存	70
  活动	保存为已完成	58
  所有	停用​​	5
  所有	重新激活	6
  负责实体的用户或团队	分派​​	47
  电子邮件 (E-mail)	发送	7
  潜在顾客	授予资格	16
  潜在​​顾客	取消资格	15

• 备注
  如果要启用组织中大多数窗体的自动保存并禁用特定窗体的自动保存，则此方法很重要。 以下注册 onSave 事件的代码（向其传递执行上下文），将阻止任何从自动保存开始的保存，但允许所有其他保存。 启用自动存储，导航走等效于保存并关闭。 此代码将阻止任何由 30 秒计时器启动的保存，或阻止用户使用未保存的数据导航回窗体的保存。

  function preventAutoSave(econtext) {
      var eventArgs = econtext.getEventArgs();
      if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
          eventArgs.preventDefault();
      }
  }
  

  若要保存记录，用户必须单击窗体底部的“保存” 图标，或单击需要添加到命令栏的自定论“保存”命令。

isDefaultPrevented

返回一个指示保存事件是否已取消的值，因为该事件处理程序或先前事件处理程序使用 preventDefault 方法。

execObj.getEventArgs().isDefaultPrevented()

• 返回值
  类型： 布尔

preventDefault

取消保存操作，但是，将执行事件的所有其余处理程序。

execObj.getEventArgs().preventDefault()

另请参阅

客户端编程引用
集合（客户端引用）
脚本即时引用的表单
执行上下文（客户端引用）
getEventArgs
为 Microsoft Dynamics 365 窗体编写代码
使用 Xrm.Page 对象模型

Microsoft Dynamics 365

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