ScriptTask.Execute 方法

参考

定义

命名空间:: Microsoft.SqlServer.Dts.Tasks.ScriptTask

程序集:: Microsoft.SqlServer.ScriptTask.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

执行此 DTS 脚本任务实例中包含的脚本。

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, 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

Public Overrides Function Execute (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging, transaction As Object) As DTSExecResult

参数

connections: Connections

任务使用的连接的集合。

variableDispenser: VariableDispenser

一个用来锁定变量的 VariableDispenser 对象。

events: IDTSComponentEvents

一个实现 IDTSComponentEvents 接口的对象。

log: IDTSLogging

一个实现 IDTSLogging 接口的对象。

transaction: Object

容器所属的事务对象。运行时基于 TransactionOption 属性提供容器的事务。此值可为 NULL。

DTSExecResult

DTSExecResult 枚举中的一个值。

示例

下面的代码示例演示如何运行包含一些任务属性之后的 BulkInsertTask 包。批量插入任务只是此代码示例的一个示例;可以创建任何任务。

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.  
            pkg.Execute();  

            // Review the results of execution.  
            if (taskH.ExecutionResult == DTSExecResult.Failure || taskH.ExecutionStatus == DTSExecStatus.Abend)  
                Console.WriteLine("Task failed or abended");  
            else  
                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.  
            pkg.Execute()  

            ' Review the results of execution.  
            If taskH.ExecutionResult = DTSExecResult.Failure Or taskH.ExecutionStatus = DTSExecStatus.Abend Then  
                Console.WriteLine("Task failed or abended")  
            Else   
                Console.WriteLine("Task ran successfully")  
            End If  
        End Sub  
    End Class  
End Namespace

注解

该方法 Execute 由任务主机和其他对象从 Executable 抽象类继承，通过 DtsContainer 该类，并使继承对象可由运行时引擎运行。 Execute单个对象继承的方法通常不用于代码，如果必须在包中运行任务或容器，则应调用Execute该方法。但是， Execute 如果在需要唯一的情况下，该方法可用于各个对象。

该方法 Execute 在包运行时隐式调用 Validate 该方法。包中的所有任务都会在验证期间查看相应的设置，并查看包中的所有对象，包括包中的包、容器和其他组件。

如果在验证阶段遇到导致包失败的问题，包对象会针对包中的每个任务和对象调用 Execute 该方法。

null属性transaction为 false..TransactionOption TransactionOption如果属性是true，则可以传入nulltransaction参数来指示容器支持事务，但不参与。

适用于

通过

ScriptTask.Execute 方法

定义

参数

返回

示例

注解

适用于