在指令碼元件中引發事件

  • 發行項

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

事件會提供向包含封裝報告錯誤、警告和其他資訊 (例如工作進度或狀態) 的方法。 封裝提供管理事件通知的事件處理常式。 指令碼元件可以呼叫 ScriptMain 類別的 ComponentMetaData 屬性上之方法以引發事件。 如需 Integration Services 套件如何處理事件的詳細資訊，請參閱 Integration Services (SSIS) 事件處理常式。

事件可以記錄到封裝中啟用的任何記錄提供者。 記錄提供者會在資料存放區中儲存事件的相關資訊。 指令碼元件也可以使用 Log 方法將資訊記錄到記錄提供者，而不會引發事件。 如需有關如何使用 Log 方法的詳細資訊，請參閱下一節。

為了引發事件，指令碼工作會呼叫 IDTSComponentMetaData100 屬性公開的 ComponentMetaData 介面之下列其中一個方法：

事件 描述
FireCustomEvent 引發封裝中使用者定義的自訂事件。
FireError 通知封裝有關錯誤狀況。
FireInformation 提供資訊給使用者。
FireProgress 通知封裝有關元件的進度。
FireWarning 通知封裝元件是在需要使用者通知的狀態，但不是錯誤狀況。

以下是引發 Error 事件的簡單範例：

Dim myMetadata as IDTSComponentMetaData100

myMetaData = Me.ComponentMetaData

myMetaData.FireError(...)

另請參閱

Integration Services (SSIS) 事件處理常式
將事件處理常式新增至套件