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
public enum DTSForcedExecResult
public enum class DTSForcedExecResult
public enum 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.

Example

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

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

Microsoft.SqlServer.Dts.Runtime Namespace