Partager via


ExecuteSQLTask.InitializeTask Méthode

Définition

Initialise les propriétés associées à la tâche d'exécution SQL. 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 Connections utilisée par la tâche.

variableDispenser
VariableDispenser

Objet VariableDispenser utilisé pour le verrouillage de variables.

events
IDTSInfoEvents

Interface IDTSComponentEvents utilisée pour déclencher des événements.

log
IDTSLogging

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 InitializeTask méthode d’une tâche personnalisée dans laquelle deux événements personnalisés sont créés et ajoutés à la EventInfos collection.

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 ExecuteSQLTask 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 d’effectuer des opérations de validation, d’exécution ou de persistance.

S’applique à