XMLTask.InitializeTask Methode

Definition

Namespace:: Microsoft.SqlServer.Dts.Tasks.XMLTask

Assembly:: Microsoft.SqlServer.XMLTask.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 mit dieser Aufgabe verbundenen Eigenschaften. Diese Methode wird von der Laufzeit aufgerufen und im Code nicht 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 Sammlung von Connections von der Aufgabe genutzten.

variableDispenser: VariableDispenser

Ein Objekt zum Sperren VariableDispenser von Variablen.

events: IDTSInfoEvents

Ein Objekt, das die IDTSInfoEvents Schnittstelle implementiert.

log: IDTSLogging

Ein Objekt, das die IDTSLogging Schnittstelle implementiert.

eventInfos: EventInfos

Eine Sammlung, die die Ereignisse enthält, die während der Ausführung der Aufgabe ausgelöst werden sollen.

logEntryInfos: LogEntryInfos

Eine Sammlung von Logbucheinträgen.

refTracker: ObjectReferenceTracker

Ein Objektreferenz-Tracker.

Beispiele

Task-Entwickler definieren benutzerdefinierte Events, indem sie die InitializeTask Methode der Task Basisklasse überschreiben und ein neues EventInfoerstellen. Das folgende Codebeispiel zeigt die InitializeTask-Methode einer benutzerdefinierten Aufgabe, bei der zwei benutzerdefinierte Ereignisse erstellt und zur eventInfos-Sammlung 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 XMLTask und alle anderen Bestandsaufgaben wird diese Methode verwendet, um die Protokollereignisse jeder Aufgabe festzulegen. Die Laufzeit-Engine ruft diese Methode unmittelbar nach der Erstellung der Aufgabe und vor Validierungs-, Ausführungs- oder Persistenzoperationen auf. Diese Methode wird im Code nicht verwendet. Wenn Sie jedoch eine benutzerdefinierte Aufgabe programmieren, müssen Sie diese Methode möglicherweise überschreiben und alle Initialisierungswerte für Ihre Aufgabe bereitstellen.

Gilt für: