次の方法で共有


DTSExecResult Enumeration

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

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

構文

'宣言
Public Enumeration DTSExecResult
public enum DTSExecResult
public enum class DTSExecResult
public enum DTSExecResult
public enum DTSExecResult

メンバ

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

解説

ランタイム エンジンは、パッケージまたはコンテナに含まれるタスクを、それらが実装する 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

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

Microsoft.SqlServer.Dts.Runtime Namespace