DataRecordsets.GetLastDataError 方法 (Visio)
會取得與錯誤 (在現有資料記錄集中,新增新的資料記錄集或重新整理其中的資料所造成) 相關聯的 Active X Data Objects (ADO) 錯誤碼、ADO 描述及資料記錄集識別碼。
注意事項
This Visio object or member is available only to licensed users of Visio Professional 2013.
語法
運算式。GetLastDataError (DataErrorCode、 DataErrorDescription、 RecordsetID)
表達 會傳回 DataRecordsets 物件的 運算式。
參數
名稱 | 必要/選用 | 資料類型 | 描述 |
---|---|---|---|
DataErrorCode | 必要 | Long | 輸出參數。 最後一個錯誤的 ADO 錯誤碼。 |
DataErrorDescription | 必要 | 字串 | 輸出參數。 最後一個錯誤的 ADO 描述。 |
RecordsetID | 必要 | Long | 輸出參數。 產生或觸發該錯誤的資料記錄集識別碼。 |
傳回值
無
註解
在 Microsoft Visio 中,與資料相關並會產生 ADO 錯誤的作業包括將新的 DataRecordset 物件新增至使用中文件的 DataRecordsets 集合,以及重新整理現有資料記錄集中的資料。
如果資料相關作業成功, GetLastDataError 方法會傳回 RecordsetID = 0、DataErrorCode = 0,而 DataErrorDescription = 「」 (空字串) 。
如果嘗試加入資料記錄集會產生錯誤,此方法會傳回 RecordsetID = 0,以及錯誤碼和描述。
如果嘗試重新整理現有資料記錄集中的資料會造成錯誤,而且如果 Visio 知道哪個資料記錄集造成錯誤,則 GetLastDataError 會傳回該資料記錄集的識別碼。
然而,Visio 可能無法明確知道哪個資料記錄集產生錯誤。 只有當您嘗試重新整理與資料來源共用相同連線之其中一個資料記錄集的資料記錄集時,才會發生這種情況。 原因是重新整理這類群組中之其中一個資料記錄集中的資料 (稱為交易的資料記錄集) 時,會重新整理該群組中的所有資料記錄集。 在此情況下,如果重新整理作業在重新整理群組中的所有資料記錄集之前失敗,Visio 會回復到該點為止已成功完成之任何資料記錄集的重新整理。
如果之後呼叫 GetLastDataError,則這個方法會傳回下列項目:
在其上呼叫 Refresh 方法以啟動後來失敗之重新整理作業的資料記錄集識別碼。
失敗重新整理作業所產生的錯誤訊息 (然而沒有方法知道失敗是否與資料記錄集具體相關,而您將這個資料記錄集的識別碼傳送給 GetLastDataError 方法)。
範例
下列 Microsoft Visual Basic for Applications (VBA) 巨集會顯示如何使用 GetLastDataError 方法,取得與最後一個資料錯誤有關的 ADO 錯誤碼、描述和資料記錄集識別碼。
Public Sub GetLastDataError_Example()
Dim vsoDataRecordsets As Visio.DataRecordsets
Dim lngCode As Long
Dim strDescription As String
Dim lngID As Long
Set vsoDataRecordsets = Visio.ActiveDocument.DataRecordsets
vsoDataRecordsets.GetLastDataError lngCode, strDescription, lngID
Debug.Print "Error code: ", lngCode
Debug.Print "Error description: ", strDescription
Debug.Print "Data recordset ID: ", lngID
End Sub
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。