Task.ExecutionValue Property

ユーザー定義のオブジェクトを返します。このフィールドは読み取り専用です。

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

構文

'宣言
Public Overridable ReadOnly Property ExecutionValue As Object

public virtual Object ExecutionValue { get; }

public:
virtual property Object^ ExecutionValue {
    Object^ get ();
}

/** @property */
public Object get_ExecutionValue ()

public function get ExecutionValue () : Object

プロパティ値

ユーザー定義のオブジェクトです。

解説

Task クラスの ExecutionValue プロパティは、タスクが実行結果に関する情報を公開したり、メッセージを送信したり、DTSExecResult 戻り値を返したりできるようにする読み取り専用のオブジェクト プロパティです。たとえば、タスクがその Execute メソッドの一部としてテーブルから行を削除すると、削除された行数は ExecutionValue として返されます。タスクのクライアントは、この値を使用してタスク間の優先順位制約を確立できます。

タスクは、ExecutionValue プロパティの基本実装や、その Execute メソッドの実行中にタスクで設定された値よりも優先されます。

使用例

次のコード例では、Task から継承されるメール送信タスクを作成し、このタスクが継承したプロパティを表示します。

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

namespace Microsoft.SqlServer.SSIS.Samples
{
    class Program
    {
        static void Main(string[] args)
        {
            Application app = new Application();
            Package pkg = new Package();
            // Add a Send Mail task to the package.
            Executable exec = pkg.Executables.Add("STOCK:SendMailTask");

            // Cast the task to its own class.
            TaskHost th = exec as TaskHost;
            SendMailTask smTask = th.InnerObject as SendMailTask;

            // Display the properties inherited from Task.
            Console.WriteLine("ExecutionValue: {0}", smTask.ExecutionValue);
            Console.WriteLine("Version: {0}", smTask.Version);
            Console.WriteLine("WaitForMe: {0}", smTask.WaitForMe);
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Imports Microsoft.SqlServer.Dts.Tasks.SendMailTask
 
Namespace Microsoft.SqlServer.SSIS.Samples
    Class Program
        Shared  Sub Main(ByVal args() As String)
            Dim app As Application =  New Application() 
            Dim pkg As Package =  New Package() 
            ' Add a Send Mail task to the package.
            Dim exec As Executable =  pkg.Executables.Add("STOCK:SendMailTask") 
 
            ' Cast the task to its own class.
            Dim th As TaskHost =  exec as TaskHost 
            Dim smTask As SendMailTask =  th.InnerObject as SendMailTask 
 
            ' Display the properties inherited from Task.
            Console.WriteLine("ExecutionValue: {0}", smTask.ExecutionValue)
            Console.WriteLine("Version: {0}", smTask.Version)
            Console.WriteLine("WaitForMe: {0}", smTask.WaitForMe)
        End Sub
    End Class
End Namespace

サンプル出力 :

ExecutionValue:

Version: 0

WaitForMe: True

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

Task Class
Task Members
Microsoft.SqlServer.Dts.Runtime Namespace