Task.ExecutionValue Propriedade

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Retorna um objeto definido pelo usuário. Este campo é somente leitura.

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

Valor da propriedade

Object

Um objeto definido pelo usuário.

Exemplos

O exemplo de código a seguir cria a tarefa Enviar Email, que herda e Taskexibe as propriedades herdadas pela tarefa.

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  

Saída de exemplo:

Executionvalue:

Versão: 0

WaitForMe: True

Comentários

A ExecutionValue propriedade da Task classe é uma propriedade de objeto somente leitura que fornece à tarefa a capacidade de expor informações sobre os resultados de sua execução, postar mensagens ou retornar o DTSExecResult valor retornado. Por exemplo, se uma tarefa excluir linhas de uma tabela como parte de seu Execute método, ela poderá retornar o número de linhas excluídas como .ExecutionValue Os clientes da tarefa poderiam usar esse valor para estabelecer restrições de precedência entre tarefas.

As tarefas substituem a implementação base da ExecutionValue propriedade e um valor definido pela tarefa durante seu Execute método.