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 for locking variables object for locking.

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メソッドを示しており、2つのカスタムイベントが作成され、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 されます。

適用対象