ScriptTask.Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object) ScriptTask.Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object) ScriptTask.Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object) Method


Executes the script contained in this instance of DTS Script Task.

 override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Execute(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log, System::Object ^ transaction);
public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Execute (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log, object transaction);
override this.Execute : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging * obj -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult


Connections Connections Connections

A collection of connections used by the task.

VariableDispenser VariableDispenser VariableDispenser

A VariableDispenser object for locking variables.

IDTSComponentEvents IDTSComponentEvents IDTSComponentEvents

An object that implements the IDTSComponentEvents interface.

IDTSLogging IDTSLogging IDTSLogging

An object that implements the IDTSLogging interface.

Object Object Object

The transaction object that the container is a part of. The runtime provides the transaction for the container, based on the TransactionOption property. This value can be null.


A value from the DTSExecResult enumeration.


The following code example shows how to run a package that contains a BulkInsertTask after some of the task properties are set. The Bulk Insert task is just an example for this code sample; any task can be created.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask  
namespace Microsoft.SqlServer.SSIS.Samples  
    class Program  
        static void Main(string[] args)  
            Package p = new Package();  
            p.InteractiveMode = true;  
            p.OfflineMode = true;  
            Executable exec1 = pkg.Executables.Add("STOCK:BulkInsertTask");  
            TaskHost th = exec1 as TaskHost;  
            // Set the CheckConstraints and DataFileType properties.             
            th.Properties["CheckConstraints"].SetValue(th, true);  
            th.Properties["DataFileType"].SetValue(th, DTSBulkInsert_DataFileType.DTSBulkInsert_DataFileType_Native);  
            // Run the package that contains the task.  
            // Review the results of execution.  
            if (taskH.ExecutionResult == DTSExecResult.Failure || taskH.ExecutionStatus == DTSExecStatus.Abend)  
                Console.WriteLine("Task failed or abended");  
                Console.WriteLine("Task ran successfully");  
Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask  
Namespace Microsoft.SqlServer.SSIS.Samples  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim p As Package =  New Package()   
            p.InteractiveMode = True  
            p.OfflineMode = True  
            Dim exec1 As Executable =  pkg.Executables.Add("STOCK:BulkInsertTask")   
            Dim th As TaskHost =  exec1 as TaskHost   
            ' Set the CheckConstraints and DataFileType properties.             
            th.Properties("CheckConstraints").SetValue(th, True)  
            th.Properties("DataFileType").SetValue(th, DTSBulkInsert_DataFileType.DTSBulkInsert_DataFileType_Native)  
            ' Run the package that contains the task.  
            ' Review the results of execution.  
            If taskH.ExecutionResult = DTSExecResult.Failure Or taskH.ExecutionStatus = DTSExecStatus.Abend Then  
                Console.WriteLine("Task failed or abended")  
                Console.WriteLine("Task ran successfully")  
            End If  
        End Sub  
    End Class  
End Namespace  


The Execute method is inherited by task hosts and other objects from the Executable abstract class, through the DtsContainer class, and enables the inheriting objects to be run by the run-time engine. The Execute method inherited by the individual objects is not ordinarily used in code, and you should call the Execute method if you have to run tasks or containers in the package. However, the Execute method is available on individual objects if you find a unique circumstance where it is required.

The Execute method calls the Validate method implicitly before the package runs. All tasks in the package are reviewed for appropriate settings during validation, and all objects in the package are reviewed, including the package, containers, and other components in the package.

If there are no problems encountered in the validation phase that would cause the package to fail, the package object calls the Execute method for each task and object in the package.

Pass null for the transaction parameter when the TransactionOption property is false. If the TransactionOption property is true, you can pass null in the transaction parameter to indicate that the container supports transactions but does not participate.

Applies to