Task.Execute Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Führt die Aufgabe aus.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Execute(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ componentEvents, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log, System::Object ^ transaction);
public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Execute (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents componentEvents, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log, object transaction);
abstract member Execute : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging * obj -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Execute : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging * obj -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overridable Function Execute (connections As Connections, variableDispenser As VariableDispenser, componentEvents As IDTSComponentEvents, log As IDTSLogging, transaction As Object) As DTSExecResult
Parameter
- connections
- Connections
Eine Auflistung der vom Task verwendeten Verbindungen.
- variableDispenser
- VariableDispenser
Ein VariableDispenser-Objekt zum Sperren von Variablen.
- componentEvents
- IDTSComponentEvents
Ein Objekt, das die IDTSComponentEvents-Schnittstelle implementiert.
- log
- IDTSLogging
Ein Objekt, das die IDTSLogging-Schnittstelle implementiert.
- transaction
- Object
Das Transaktionsobjekt, dem der Container angehört. Dieser Wert kann NULL sein.
Gibt zurück
Ein Wert aus der DTSExecResult-Enumeration.
Beispiele
Im folgenden Codebeispiel wird gezeigt, wie sie ein Paket ausführen, das einen In-Erben von Task, dem .BulkInsertTask Die Aufgabe "Massen einfügen" ist ein Beispiel für dieses Codebeispiel; jede Aufgabe kann an seinem Ort erstellt werden.
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");
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask
Namespace Microsoft.SqlServer.SSIS.Samples
Class Program
Shared Sub Main(ByVal args() As String)
Dim p As Package = New Package()
p.InteractiveMode = True
p.OfflineMode = True
Dim exec1 As Executable = pkg.Executables.Add("STOCK:BulkInsertTask")
Dim th As TaskHost = 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 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
Hinweise
Die Execute Methode wird von Taskhosts und anderen Objekten aus der abstrakten Klasse, über die DtsContainerExecutable Klasse geerbt und ermöglicht die Ausführung von Objekten durch das Laufzeitmodul. Die Execute
von den einzelnen Objekten geerbte Methode wird nicht häufig im Code verwendet, und es wird empfohlen, die Execute Methode aufzurufen, wenn Sie eine der Aufgaben oder Container im Paket ausführen müssen. Die Execute
Methode ist jedoch für einzelne Objekte verfügbar, wenn Sie einen einzigartigen Umstand finden, in dem sie benötigt wird.
Die Hauptverwendung der Execute
Methode besteht darin, geerbt und außer Kraft gesetzt zu werden, wenn Sie eine benutzerdefinierte Aufgabe erstellen. Weitere Informationen zum Außerkraftsetzen der Execute
Methode finden Sie unter Codieren einer benutzerdefinierten Aufgabe.
Die Execute
Methode ruft die Validate
Methode implizit auf, bevor das Paket ausgeführt wird. Alle Aufgaben im Paket werden während der Überprüfung auf geeignete Einstellungen überprüft, und alle Objekte im Paket werden überprüft, einschließlich des Pakets, der Container und anderer Komponenten im Paket.
Wenn in der Überprüfungsphase keine Probleme auftreten, die dazu führen würden, dass das Paket fehlschlägt, wird das Paketobjekt fortgesetzt, um die Execute
Methode für jede Aufgabe und jedes Objekt im Paket aufzurufen.
Übergeben Sie null
den transaction
Parameter, wenn die TransactionOption Eigenschaft lautet false
. Wenn die TransactionOption Eigenschaft true ist, können Sie den transaction
Parameter übergebennull
, um anzugeben, dass der Container Transaktionen unterstützt, aber nicht teilnimmt.