TransferDatabaseTask.InitializeTask Méthode
Définition
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. 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 de connexions utilisées 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 des é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, où 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 la tâche de transfert de base de données et toutes les autres tâches de stock, le moteur d’exécution appelle InitializeTask immédiatement après la création de la tâche, avant la validation, l’exécution ou les opérations de persistance.
Cette méthode permet d’initialiser les propriétés associées à chaque tâche et de définir les événements de journal de chaque tâche.