Task.ExecutionValue Propriété

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

Valeur de propriété

Objet défini par l’utilisateur.

Exemples

L’exemple de code suivant crée la tâche Envoyer un courrier, qui hérite de Task, puis affiche les propriétés que la tâche a héritées.

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  

Exemple de sortie :

ExecutionValue :

Version : 0

WaitForMe : Vrai

Remarques

La ExecutionValue propriété de la Task classe est une propriété d’objet en lecture seule qui permet à la tâche d’exposer des informations concernant les résultats de son exécution, de poster des messages ou de retourner la DTSExecResult valeur de retour. Par exemple, si une tâche supprime des lignes d’une table dans le cadre de sa Execute méthode, elle peut retourner le nombre de lignes supprimées comme le ExecutionValue. Les clients de la tâche pouvaient alors utiliser cette valeur pour établir des contraintes de priorité entre les tâches.

Les tâches supplantent l’implémentation de base de la ExecutionValue propriété et une valeur définie par la tâche pendant sa Execute méthode.