Package.Execute Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Devuelve una enumeración DTSExecResult que contiene información sobre la ejecución correcta o incorrecta del paquete.

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

Devoluciones

DTSExecResult

Enumeración DTSExecResult que contiene información sobre la ejecución correcta o incorrecta del paquete.

Ejemplos

En el ejemplo de código siguiente se crea un paquete, se establecen las OfflineMode propiedades y InteractiveMode antes de agregar una tarea de script. A continuación, ejecuta el paquete mediante el Execute método .

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  

Comentarios

El Execute método lo heredan los hosts de tareas y otros objetos de la Executable clase abstracta, a través de la DtsContainer clase y permite que el motor en tiempo de ejecución ejecute los objetos heredados. El Execute método heredado por los objetos individuales no se usa normalmente en el código y se recomienda llamar al Execute método si necesita ejecutar cualquiera de las tareas o contenedores del paquete. Sin embargo, el Execute método está disponible en objetos individuales si encuentra una circunstancia única en la que se necesita.

El uso principal del Execute método es que se herede y se invalide al crear una tarea personalizada. Para obtener más información sobre cómo invalidar el método Execute, consulte Codificación de una tarea personalizada.

El Execute método llama implícitamente al Validate método antes de que se ejecute el paquete. Todas las tareas del paquete se revisan para obtener la configuración adecuada durante la validación y se revisan todos los objetos del paquete, incluidos el paquete, los contenedores y otros componentes del paquete.

Si no hay ningún problema en la fase de validación que provocaría un error en el paquete, el objeto de paquete continúa llamando al Execute método para cada tarea y objeto del paquete.

Pase null para el transaction parámetro cuando la TransactionOption propiedad sea false. Si la TransactionOption propiedad es true, puede pasar null el transaction parámetro para indicar que el contenedor admite transacciones, pero no participa.