Package.Execute Package.Execute Package.Execute Method

정의

반환 된 DTSExecResult 패키지 실행의 성공 여부에 대 한 정보를 포함 하는 열거형입니다. Returns a DTSExecResult enumeration that contains information about the success or failure of the package execution.

public:
 Microsoft::SqlServer::Dts::Runtime::DTSExecResult Execute();
public Microsoft.SqlServer.Dts.Runtime.DTSExecResult Execute ();
Public Function Execute () As DTSExecResult
반환

A DTSExecResult 패키지 실행의 성공 여부에 대 한 정보를 포함 하는 열거형입니다. A DTSExecResult enumeration that contains information about the success or failure of the package execution.

예제

다음 코드 예제에서는 패키지 집합을 만듭니다는 OfflineModeInteractiveMode 스크립트 태스크를 추가 하기 전에 속성입니다.The following code example creates a package, sets the OfflineMode and InteractiveMode properties before adding a script task. 그런 다음 사용 하 여 패키지 실행의 Execute 메서드.It then runs the package using the Execute method.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.ScriptTask;  

namespace Package_API  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package p = new Package();  
            p.InteractiveMode = true;  
            p.OfflineMode = true;  

            // Add a Script Task to the package.  
            TaskHost taskH = (TaskHost)p.Executables.Add(typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTask).AssemblyQualifiedName);  
            // Run the package.  
            p.Execute();  
            // Review the results of the run.  
            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.ScriptTask  

Namespace Package_API  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim p As Package =  New Package()   
            p.InteractiveMode = True  
            p.OfflineMode = True  

            ' Add a Script Task to the package.  
            Dim taskH As TaskHost = CType(p.Executables.Add(Type.GetType(Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTask).AssemblyQualifiedName), TaskHost)  
            ' Run the package.  
            p.Execute()  
            ' Review the results of the run.  
            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 클래스와 런타임 엔진에 의해 실행 되도록 개체 상속을 허용 합니다.The Execute method is inherited by task hosts and other objects from the Executable abstract class, through the DtsContainer class, and allows the inheriting objects to be run by the runtime engine. Execute 개별 개체에 의해 상속 된 메서드는 코드에서 일반적으로 사용 되지 않으며 호출 하는 것이 좋습니다.는 Execute 메서드는 패키지의 태스크 또는 컨테이너 중 하나를 실행 해야 할 경우.The Execute method inherited by the individual objects is not commonly used in code, and it is recommended that you call the Execute method if you need to run any of the tasks or containers in the package. 그러나는 Execute 발견 고유 환경에서 필요한 경우 메서드는 개별 개체에 사용할 수 있습니다.However, the Execute method is available on individual objects should you find a unique circumstance where it is needed.

기본 사용은 Execute 메서드는 상속 하 고 사용자 지정 태스크를 만들 때 재정의 됩니다.The main use of the Execute method is for it to be inherited and overridden when you create a custom task. Execute 메서드를 재정의 하는 방법에 대 한 자세한 내용은 참조 사용자 지정 태스크 코딩합니다.For more information about how to override the Execute method, see Coding a Custom Task.

Execute 메서드 호출에서 Validate 메서드 패키지가 실행 되기 전에 암시적으로 합니다.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.

패키지가 실패를 발생 시키는 유효성 검사 단계에서 발생 한 문제가 없는지, 패키지 개체를 호출 진행는 Execute 각 태스크와 패키지 개체에에서 대해 메서드.If there are no problems encountered in the validation phase that would cause the package to fail, the package object proceeds to call the Execute method for each task and object in the package.

전달 null 에 대 한는 transaction 매개 변수는 경우는 TransactionOption 속성은 false합니다.Pass null for the transaction parameter when the TransactionOption property is false. 경우는 TransactionOption 속성이 true 이면 전달할 수 있습니다 nulltransaction 나타내는 컨테이너에서 트랜잭션을 지원 하지만 참여 하지 않는 매개 변수를 합니다.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.

적용 대상