儲存事件引數 (用戶端參考)

發行︰ 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
  電子郵件	傳送	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. 著作權所有，並保留一切權利。 著作權