DTSExecResult 列挙体

タスクの実行結果を示す値を提供します。

名前空間:  Microsoft.SqlServer.Dts.Runtime
アセンブリ:  Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)

構文

'宣言
Public Enumeration DTSExecResult
'使用
Dim instance As DTSExecResult
public enum DTSExecResult
public enum class DTSExecResult
type DTSExecResult
public enum DTSExecResult

メンバー

メンバー名 説明
Failure タスクは失敗しました (値 = 1)。
Success タスクは正常に実行されました (値 = 0)。
Completion タスクの実行が完了しました (値 = 2)。
Canceled タスクはキャンセルされました (値 = 3)。

説明

ランタイム エンジンは、パッケージまたはコンテナに含まれるタスクを、それらが実装する Execute メソッドを呼び出すことにより処理します。このメソッド内にコア ロジックや機能を実装したタスクは、メッセージを送信したり、DTSExecResult 列挙から値を返すことにより、実行結果を提供します。

使用例

次のコード例は、DTSExecResult 列挙をパッケージで使用する 1 つの方法を示しています。Package クラスは、この列挙を Execute メソッドの戻り値として使用して、パッケージの実行が成功したかどうかを判断します。

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("STOCK:ScriptTask");
            // 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("STOCK:ScriptTask"), 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

サンプルの出力 :

Task ran successfully