IDTSEvents Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert einen Ereignissatz, der von TaskHost im Auftrag eines Tasks verwendet wird.
public interface class IDTSEventspublic interface IDTSEventstype IDTSEvents = interfacePublic Interface IDTSEvents- Abgeleitet
Hinweise
Für jede Methode gibt es ein verwandtes Objekt in der DtsEventHandlers Auflistung, das das Ereignis behandelt. Wenn das Ereignis deaktiviert ist, wird das Objekt nicht ausgeführt und wird zurückgegeben false. Wenn das Objekt das Ereignis nicht auf lokaler Ebene behandelt, wird das Ereignis an den übergeordneten Container eskaliert, der behandelt werden soll.
Diese Methoden stellen Indizes in der Ereignisauflistung für den entsprechenden Ereignishandler bereit.
Methoden
| OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) |
Wird aufgerufen, wenn ein Breakpoint innerhalb eines Tasks erreicht wird. |
| OnCustomEvent(TaskHost, String, String, Object[], String, Boolean) |
Wird durch Tasks aufgerufen, um benutzerdefinierte Taskereignisse auszulösen. |
| OnError(DtsObject, Int32, String, String, String, Int32, String) |
Wird durch einen Task oder Container bei einem Fehler aufgerufen. |
| OnExecutionStatusChanged(Executable, DTSExecStatus, Boolean) |
Wird von einem Task oder Container aufgerufen, wenn sich deren Ausführungsstatus ändert. |
| OnInformation(DtsObject, Int32, String, String, String, Int32, String, Boolean) |
Wird aufgerufen, wenn der Task Informationen bereitstellen muss. |
| OnPostExecute(Executable, Boolean) |
Wird aufgerufen, unmittelbar nachdem die Ausführungslogik des Tasks beendet wurde. Dieses Ereignis wird durch einen Task oder Container ausgelöst, unmittelbar nachdem er ausgeführt wurde. |
| OnPostValidate(Executable, Boolean) |
Wird aufgerufen, unmittelbar nachdem die Überprüfungslogik des Tasks beendet wurde. Dieses Ereignis wird von einem Task ausgelöst, nachdem der Task überprüft wurde. |
| OnPreExecute(Executable, Boolean) |
Wird aufgerufen, unmittelbar bevor ein Task ausgeführt wird. Dieses Ereignis wird durch einen Task oder Container ausgelöst, unmittelbar bevor er ausgeführt wird. |
| OnPreValidate(Executable, Boolean) |
Wird aufgerufen, sobald die tatsächliche Überprüfungslogik des Tasks gestartet wird. Dieses Ereignis wird ausgelöst, sobald die Überprüfung des Taskhosts oder Containers beginnt. |
| OnProgress(TaskHost, String, Int32, Int32, Int32, String, Boolean) |
Wird aufgerufen, um den Status der Taskausführung zu aktualisieren. |
| OnQueryCancel() |
Wird an jedem Punkt der Taskverarbeitung aufgerufen, an dem ein Abbruch der Ausführung sinnvoll ist. Dieses Ereignis wird von Tasks und Containern ausgelöst, um zu bestimmen, ob ihre Ausführung beendet werden soll. |
| OnTaskFailed(TaskHost) |
Wird durch den Taskhost bei einem Fehler aufgerufen. |
| OnVariableValueChanged(DtsContainer, Variable, Boolean) |
Wird von der Runtime-Engine aufgerufen. Wird nicht von Tasks aufgerufen. |
| OnWarning(DtsObject, Int32, String, String, String, Int32, String) |
Wird aufgerufen, sobald sich der Task in einem Zustand befindet, der keinen Fehler, aber eine Warnung des Clients rechtfertigt. |