Package.Execute Méthode

Définition

Espace de noms:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Retourne une énumération DTSExecResult qui contient des informations sur la réussite ou l'échec de l'exécution du package.

public:
 Microsoft::SqlServer::Dts::Runtime::DTSExecResult Execute();

public Microsoft.SqlServer.Dts.Runtime.DTSExecResult Execute ();

override this.Execute : unit -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Function Execute () As DTSExecResult

Retours

DTSExecResult

Énumération DTSExecResult qui contient des informations sur la réussite ou l'échec de l'exécution du package.

Exemples

L’exemple de code suivant crée un package, définit les propriétés et InteractiveMode les OfflineMode éléments avant d’ajouter une tâche de script. Il exécute ensuite le package à l’aide de la Execute méthode.

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(typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTask).AssemblyQualifiedName);  
            // 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(Type.GetType(Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTask).AssemblyQualifiedName), 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  

Remarques

La Execute méthode est héritée par les hôtes de tâches et d’autres objets de la Executable classe abstraite, par le biais de la DtsContainer classe et permet aux objets hérités d’être exécutés par le moteur d’exécution. La Execute méthode héritée par les objets individuels n’est pas couramment utilisée dans le code, et il est recommandé d’appeler la Execute méthode si vous devez exécuter l’une des tâches ou conteneurs dans le package. Toutefois, la Execute méthode est disponible sur des objets individuels si vous trouvez une circonstance unique où elle est nécessaire.

L’utilisation principale de la Execute méthode est qu’elle doit être héritée et remplacée lorsque vous créez une tâche personnalisée. Pour plus d’informations sur la façon de remplacer la méthode Execute, consultez Codage d’une tâche personnalisée.

La Execute méthode appelle implicitement la Validate méthode avant l’exécution du package. Toutes les tâches du package sont examinées pour les paramètres appropriés lors de la validation, et tous les objets du package sont examinés, y compris le package, les conteneurs et d’autres composants du package.

S’il n’y a aucun problème rencontré dans la phase de validation qui entraînerait l’échec du package, l’objet de package passe à appeler la Execute méthode pour chaque tâche et objet dans le package.

null Passez le transaction paramètre lorsque la TransactionOption propriété est false. Si la TransactionOption propriété est true, vous pouvez transmettre null le transaction paramètre pour indiquer que le conteneur prend en charge les transactions, mais ne participe pas.