ExecuteSQLTask.InitializeTask Méthode

Définition

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

Assembly:: Microsoft.SqlServer.SQLTask.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 à la tâche Exécuter SQL. 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 Connections collection utilisée pour la tâche.

variableDispenser: VariableDispenser

Un VariableDispenser objet pour verrouiller les variables.

events: IDTSInfoEvents

Une IDTSComponentEvents interface pour lancer des événements.

log: IDTSLogging

Interface IDTSLogging.

eventInfos: EventInfos

Une collection contenant les événements à soulever 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 InitializeTask méthode d’une tâche personnalisée dans laquelle deux événements personnalisés sont créés, puis 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 les ExecuteSQLTask 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 qu’elle n’effectue des opérations de validation, d’exécution ou de persistance.

S’applique à