XMLTask.InitializeTask Méthode

Définition

Espace de noms:: Microsoft.SqlServer.Dts.Tasks.XMLTask

Assembly:: Microsoft.SqlServer.XMLTask.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise les propriétés associées à cette tâche. Cette méthode est appelée par l’exécution et n’est pas utilisée dans le code.

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)

Paramètres

connections: Connections

Une collection d’utilisations Connections par la tâche.

variableDispenser: VariableDispenser

Un VariableDispenser objet pour verrouiller les variables.

events: IDTSInfoEvents

Objet qui implémente l’interface IDTSInfoEvents .

log: IDTSLogging

Objet qui implémente l’interface IDTSLogging .

eventInfos: EventInfos

Une collection contenant les événements à déclencher lors de l’exécution de la tâche.

logEntryInfos: LogEntryInfos

Une collection d’entrées de journal.

refTracker: ObjectReferenceTracker

Un traceur de référence d’objets.

Exemples

Les développeurs de tâches définissent des événements personnalisés en supplantant la InitializeTask méthode de la Task classe de base, et en créant un nouveau EventInfofichier . L’exemple de code suivant montre la méthode InitializeTask d’une tâche personnalisée, où deux événements personnalisés sont créés et ajoutés à la collection 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"];  
}

Remarques

Pour les XMLTask tâches et toutes les autres tâches stock, cette méthode est utilisée pour définir les événements journaliers de chaque tâche. Le moteur d’exécution appelle cette méthode immédiatement après la création de la tâche, et avant les opérations de validation, d’exécution ou de persistance. Cette méthode n’est pas utilisée dans le code. Cependant, si vous codez une tâche personnalisée, il se peut que vous deviez contourner cette méthode et fournir les valeurs d’initialisation de votre tâche.

S’applique à