DTSForcedExecResult Enumeration
Specifies the execution result of a container when the container's ForceExecutionValue is set to true.
Namespace: Microsoft.SqlServer.Dts.Runtime
Assembly: Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)
Syntax
'Declaration
Public Enumeration DTSForcedExecResult
'Usage
Dim instance As DTSForcedExecResult
public enum DTSForcedExecResult
public enum class DTSForcedExecResult
type DTSForcedExecResult
public enum DTSForcedExecResult
Members
| Member name | Description | |
|---|---|---|
| Completion | The execution result is set to Completion. | |
| Failure | The execution result is set to Failure. | |
| None | The execution result is set to None. The event handler returns the actual execution result; the result is not forced. | |
| Success | The execution result is set to Success. |
Remarks
This enumeration is available to containers that need to force a specific execution result. You can use the ForceExecutionResult property on a container to test the use of checkpoints in a package. By setting ForceExecutionResult of a task or container to Failure, you can imitate real-time failure. When you rerun the package, failed task and containers will be rerun.
Examples
The following code example creates a new package, and explicitly sets the ForceExecutionResult on the Package to Failure.
Package pkg = new Package();
Pkg.ForceExecutionResult = DTSForcedExecResult.Failure;
Dim pkg As Package = New Package()
Pkg.ForceExecutionResult = DTSForcedExecResult.Failure