ExecuteSQLTask.InitializeTask Methode
Definition
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 "SQL ausführen" 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 vom Task verwendete Connections-Auflistung.
- variableDispenser
- VariableDispenser
Ein VariableDispenser-Objekt zum Sperren von Variablen.
- events
- IDTSInfoEvents
Eine IDTSComponentEvents-Schnittstelle zum Auslösen von Ereignissen.
- log
- IDTSLogging
Eine IDTSLogging-Schnittstelle.
- eventInfos
- EventInfos
Eine Auflistung mit den 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 EventInfoerstellen. Das folgende Codebeispiel zeigt die InitializeTask
Methode einer benutzerdefinierten Aufgabe, in 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 ExecuteSQLTask und alle anderen Lageraufgaben wird diese Methode verwendet, um die Protokollereignisse jeder Aufgabe festzulegen.
Das Laufzeitmodul ruft diese Methode unmittelbar nach dem Erstellen der Aufgabe auf und führt vor dem Ausführen von Validierungs-, Ausführungs- oder Persistenzvorgängen aus.