XMLTask.InitializeTask Méthode

Référence

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 le runtime 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

Collection d'objets Connections utilisés par la tâche.

variableDispenser: VariableDispenser

Objet VariableDispenser utilisé pour le verrouillage de variables.

events: IDTSInfoEvents

Objet qui implémente l'interface IDTSInfoEvents.

log: IDTSLogging

Objet qui implémente l'interface IDTSLogging.

eventInfos: EventInfos

Collection qui contient les événements à déclencher pendant l'exécution de la tâche.

logEntryInfos: LogEntryInfos

Collection d'entrées de journal.

refTracker: ObjectReferenceTracker

Dispositif de suivi de référence d'objet.

Exemples

Les développeurs de tâches définissent des événements personnalisés en remplaçant la InitializeTask méthode de la Task classe de base et en créant un nouveau EventInfo. 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 toutes XMLTask les autres tâches de stock, cette méthode est utilisée pour définir les événements de journal 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. Toutefois, si vous codez une tâche personnalisée, vous devrez peut-être remplacer cette méthode et fournir des valeurs d’initialisation pour votre tâche.

S’applique à

Share via