Task.ExecutionValue Свойство

Определение

Пространство имен:

Microsoft.SqlServer.Dts.Runtime

Сборка:

Microsoft.SqlServer.ManagedDTS.dll

Возвращает пользовательский объект. Это поле доступно только для чтения.

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

public virtual object ExecutionValue { get; }

member this.ExecutionValue : obj

Public Overridable ReadOnly Property ExecutionValue As Object

Значение свойства

Object

Определяемый пользователем объект.

Примеры

Следующий пример кода создаёт задачу Send Mail, которая наследует из 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:

Версия: 0

WaitForMe: Правда

Комментарии

Свойство ExecutionValueTask класса — это свойство объекта только для чтения, которое даёт задаче возможность предоставлять информацию о результатах её выполнения, отправлять сообщения или возвращать возвращаемое DTSExecResult значение. Например, если задача удаляет строки из таблицы в рамках своего Execute метода, она может вернуть количество удалённых строк как ExecutionValue. Клиенты задачи могли использовать это значение для установления ограничений по приоритету между задачами.

Задачи переопределяют базовую реализацию свойства ExecutionValue и значение, задаемое задачей в ходе её Execute метода.