IDTSEvents Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Defines a set of events used by the TaskHost on behalf of a task.
public interface class IDTSEventspublic interface IDTSEventstype IDTSEvents = interfacePublic Interface IDTSEvents- Derived
Remarks
For each method, there is a related object in the DtsEventHandlers collection that handles the event. If the event is disabled, the object will not execute and will return false. If the object does not handle the event at the local level, the event is escalated to the parent container to be handled.
These methods provide indexes into the events collection for the corresponding event handler.
Methods
| OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) |
Called when a breakpoint is hit within a task. |
| OnCustomEvent(TaskHost, String, String, Object[], String, Boolean) |
Called by tasks to raise custom task-defined events. |
| OnError(DtsObject, Int32, String, String, String, Int32, String) |
Called by a task or container when an error occurs. |
| OnExecutionStatusChanged(Executable, DTSExecStatus, Boolean) |
Called by a task or container when its execution status changes. |
| OnInformation(DtsObject, Int32, String, String, String, Int32, String, Boolean) |
Called any time the task is required to provide information. |
| OnPostExecute(Executable, Boolean) |
Called immediately after the execution logic of the task completes. This event is raised by a task or container immediately after it runs. |
| OnPostValidate(Executable, Boolean) |
Called immediately after the validation logic of the task completes. This event is raised by a task after the task is validated. |
| OnPreExecute(Executable, Boolean) |
Called when a task is about to execute. This event is raised by a task or a container immediately before it runs. |
| OnPreValidate(Executable, Boolean) |
Called when the actual validation logic of the task starts. This event is raised when the validation of the task host or container begins. |
| OnProgress(TaskHost, String, Int32, Int32, Int32, String, Boolean) |
Called to update progress about task execution. |
| OnQueryCancel() |
Called at any juncture in task processing where it is feasible to cancel execution. This event is raised by tasks and containers to determine whether they should stop running. |
| OnTaskFailed(TaskHost) |
Called by the task host when it fails. |
| OnVariableValueChanged(DtsContainer, Variable, Boolean) |
Called by the run-time engine. It is not called by tasks. |
| OnWarning(DtsObject, Int32, String, String, String, Int32, String) |
Called any time the task is in a state that does not justify an error, but does warrant alerting the client. |