Metodo Execute

Runs the task.

Spazio dei nomi  Microsoft.SqlServer.Dts.Runtime
Assembly:  Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)

public virtual DTSExecResult Execute(
	Connections connections,
	VariableDispenser variableDispenser,
	IDTSComponentEvents componentEvents,
	IDTSLogging log,
	Object transaction
)

Parametri

connections
Tipo: Microsoft.SqlServer.Dts.Runtime..::..Connections
A collection of connections used by the task.
variableDispenser
Tipo: Microsoft.SqlServer.Dts.Runtime..::..VariableDispenser
A VariableDispenser object for locking variables.
componentEvents
Tipo: Microsoft.SqlServer.Dts.Runtime..::..IDTSComponentEvents
An object that implements the IDTSComponentEvents interface.
log
Tipo: Microsoft.SqlServer.Dts.Runtime..::..IDTSLogging
An object that implements the IDTSLogging interface.
transaction
Tipo: System..::..Object
The transaction object that the container is a part of. This value can be nullNothingnullptrunitriferimento Null (Nothing in Visual Basic)..

Valore restituito

Tipo: Microsoft.SqlServer.Dts.Runtime..::..DTSExecResult
A value from the DTSExecResult enumeration.

The Execute method is inherited by task hosts and other objects from the Executable abstract class, through the DtsContainer class, and allows the inheriting objects to be run by the runtime engine. The Execute method inherited by the individual objects is not commonly used in code, and it is recommended that you call the Execute method if you need to run any of the tasks or containers in the package. However, the Execute method is available on individual objects should you find a unique circumstance where it is needed.

The main use of the Execute method is to be inherited and overridden when you create a custom task. For more information about how to override the Execute method, see Scrittura del codice di un'attività personalizzata.

The Execute method calls the Validate method implicitly before the package runs. All tasks in the package are reviewed for appropriate settings during validation, and all objects in the package are reviewed, including the package, containers, and other components in the package.

If there are no problems encountered in the validation phase that would cause the package to fail, the package object proceeds to call the Execute method for each task and object in the package.

Pass nullNothingnullptrunitriferimento Null (Nothing in Visual Basic). for the transaction parameter when the TransactionOption property is false. If the TransactionOption property is true, you can pass null in the transaction parameter to indicate that the container supports transactions but does not participate.

The following code example shows how to run a package containing a in inheritor of Task, the BulkInsertTask. The Bulk Insert task is an example for this code sample; any task can be created in its place.

Before running the code, make sure to add a reference to the Microsoft.SqlServer.ManagedDTS assembly.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask

namespace Microsoft.SqlServer.SSIS.Samples
{
    class Program
    {
        static void Main(string[] args)
        {
            Package p = new Package();
            p.InteractiveMode = true;
            p.OfflineMode = true;
            Executable exec1 = pkg.Executables.Add("STOCK:BulkInsertTask");
            TaskHost th = exec1 as TaskHost;

            // Set the CheckConstraints and DataFileType properties.           
            th.Properties["CheckConstraints"].SetValue(th, true);
            th.Properties["DataFileType"].SetValue(th, DTSBulkInsert_DataFileType.DTSBulkInsert_DataFileType_Native);
           
            // Run the package that contains the task.
            pkg.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");
        }
    }
}

Aggiunte alla community

AGGIUNGI
Mostra: