SendMailTask.InitializeTask 方法

定義

命名空間:: Microsoft.SqlServer.Dts.Tasks.SendMailTask

組件:: Microsoft.SqlServer.SendMailTask.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化與任務相關的屬性。此方法由執行時呼叫，程式碼中不使用。

public:
 override void InitializeTask(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log, Microsoft::SqlServer::Dts::Runtime::EventInfos ^ eventInfos, Microsoft::SqlServer::Dts::Runtime::LogEntryInfos ^ logEntryInfos, Microsoft::SqlServer::Dts::Runtime::ObjectReferenceTracker ^ refTracker);

public override void InitializeTask(Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log, Microsoft.SqlServer.Dts.Runtime.EventInfos eventInfos, Microsoft.SqlServer.Dts.Runtime.LogEntryInfos logEntryInfos, Microsoft.SqlServer.Dts.Runtime.ObjectReferenceTracker refTracker);

override this.InitializeTask : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging * Microsoft.SqlServer.Dts.Runtime.EventInfos * Microsoft.SqlServer.Dts.Runtime.LogEntryInfos * Microsoft.SqlServer.Dts.Runtime.ObjectReferenceTracker -> unit

Public Overrides Sub InitializeTask (connections As Connections, variableDispenser As VariableDispenser, events As IDTSInfoEvents, log As IDTSLogging, eventInfos As EventInfos, logEntryInfos As LogEntryInfos, refTracker As ObjectReferenceTracker)

參數

connections: Connections

任務中使用的一系列連結。

variableDispenser: VariableDispenser

一個P：Microsoft。SqlServer.Dts.Runtime.DtsContainer.VariableDispenser object for locking variables.

events: IDTSInfoEvents

一個實作 T：Microsoft 的物件。SqlServer.Dts.Runtime.IDTSInfoEvents interface.

log: IDTSLogging

一個實作 T：Microsoft 的物件。SqlServer.Dts.Runtime.IDTSLogging interface.

eventInfos: EventInfos

一個包含任務執行過程中要觸發的事件的集合。

logEntryInfos: LogEntryInfos

一堆日誌記錄。

refTracker: ObjectReferenceTracker

一個物件參考追蹤器。

範例

任務開發者透過覆寫 InitializeTask 基底類別的方法 Task ，並建立新的 EventInfo。以下程式碼範例展示了自訂任務的 InitializeTask 方法，在此中建立了兩個自訂事件，並加入 eventInfos 集合。

public override void InitializeTask(Connections connections, VariableDispenser variables, IDTSInfoEvents events, IDTSLogging log, EventInfos eventInfos, LogEntryInfos logEntryInfos, ObjectReferenceTracker refTracker)  
{  
    this.eventInfos = eventInfos;  
    string[] paramNames = new string[1];  
    TypeCode[] paramTypes = new TypeCode[1]{TypeCode.Int32};  
    string[] paramDescriptions = new string[1];  

    paramNames[0] = "InitialValue";  
    paramDescriptions[0] = "The value before increment.";  

    this.eventInfos.Add("OnBeforeIncrement","Fires before the task increments the value.",true,paramNames,paramTypes,paramDescriptions);  
    this.onBeforeIncrement = this.eventInfos["OnBeforeIncrement"];  

    paramDescriptions[0] = "The value after increment.";  
    this.eventInfos.Add("OnAfterIncrement","Fires after the initial value is updated.",true,paramNames, paramTypes,paramDescriptions);  
    this.onAfterIncrement = this.eventInfos["OnAfterIncrement"];  
}

備註

對於 SendMailTask 所有庫存任務，此方法用於設定每個任務的日誌事件。

SSIS 執行時會立即呼叫 InitializeTask 任務建立後，在驗證、執行或持久化操作之前進行。

適用於