SendMailTask.InitializeTask Methode

Referenz

Definition

Namespace:: Microsoft.SqlServer.Dts.Tasks.SendMailTask

Assembly:: Microsoft.SqlServer.SendMailTask.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert die dem Task zugeordneten Eigenschaften. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet.

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)

Parameter

connections: Connections

Eine Auflistung der vom Task verwendeten Verbindungen.

variableDispenser: VariableDispenser

Ein Objekt „P:Microsoft.SqlServer.Dts.Runtime.DtsContainer.VariableDispenser“ zum Sperren von Variablen

events: IDTSInfoEvents

Ein Objekt, das die Schnittstelle „T:Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents“ implementiert

log: IDTSLogging

Ein Objekt, das die Schnittstelle „T:Microsoft.SqlServer.Dts.Runtime.IDTLogging“ implementiert

eventInfos: EventInfos

Eine Auflistung mit Ereignissen, die während der Ausführung des Tasks ausgelöst werden.

logEntryInfos: LogEntryInfos

Eine Auflistung von Protokolleinträgen.

refTracker: ObjectReferenceTracker

Eine Objektverweisnachverfolgung.

Beispiele

Aufgabenentwickler definieren benutzerdefinierte Ereignisse, indem Sie die InitializeTask Methode der Task Basisklasse außer Kraft setzen und ein neues erstellen EventInfo. Das folgende Codebeispiel zeigt die InitializeTask-Methode einer benutzerdefinierten Aufgabe, bei der zwei benutzerdefinierte Ereignisse erstellt und der EventInfos-Auflistung hinzugefügt werden.

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"];  
}

Hinweise

Für die SendMailTask und alle anderen Aktienaufgaben wird diese Methode verwendet, um die Protokollereignisse jeder Aufgabe festzulegen.

Die SSIS-Laufzeit ruft InitializeTask unmittelbar nach dem Erstellen der Aufgabe vor der Überprüfung, Ausführung oder Beharrungsvorgänge auf.

Gilt für: