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

文章
07/06/2017

發佈日期： 2016年11月

適用對象： Dynamics CRM 2015

在檔案事件，您可以使用執行內容物件 279ca720-e304-4e51-b99f-91722431c2c8#BKMK_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()

另請參閱

用戶端程式設計參考
 集合 (用戶端參考)
表單指令碼快速參考
 執行內容 (用戶端參考)
279ca720-e304-4e51-b99f-91722431c2c8#BKMK_GetEventArgs
撰寫 Microsoft Dynamics CRM 2015 表單的程式碼
 使用 Xrm.Page 物件模型

© 2017 Microsoft. 著作權所有，並保留一切權利。著作權