Delen via


TaskHost.ExecValueVariable Property

Gets or sets the custom Variable that contains the execution results of the task.

Namespace:  Microsoft.SqlServer.Dts.Runtime
Assembly:  Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)

Syntax

'Declaration
Public Property ExecValueVariable As Variable
    Get
    Set
'Usage
Dim instance As TaskHost
Dim value As Variable

value = instance.ExecValueVariable

instance.ExecValueVariable = value
public Variable ExecValueVariable { get; set; }
public:
property Variable^ ExecValueVariable {
    Variable^ get ();
    void set (Variable^ value);
}
member ExecValueVariable : Variable with get, set
function get ExecValueVariable () : Variable
function set ExecValueVariable (value : Variable)

Property Value

Type: Microsoft.SqlServer.Dts.Runtime.Variable
A custom Variable that contains the execution results.

Remarks

The name of the custom variable that contains the execution result for the task. The default value of this property is none, which indicates that the result is not set to a variable in the package.

The TaskHost exposes the ExecutionValue property through the ExecValueVariable property. The task uses the ExecutionValue property to provide optional, supplemental information about the results of execution. The ExecValueVariable property allows the user to map the ExecutionValue that the task returns to any variable that is visible to the task. The package could then use the value that is returned as one of the criteria for determining the next task to run in the control flow. For example, if a task deletes rows from a table as part of its Execute method, the task might return the number of rows deleted as the ExecutionValue. Clients of the task could then use this value to define expressions in precedence constraints between tasks.