WmiDataReaderTask.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:
override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Execute(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log, System::Object ^ transaction);
public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Execute (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log, object transaction);
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 Overrides Function Execute (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging, transaction As Object) As DTSExecResult
Parameter
- connections
- Connections
Eine Connections-Auflistung für den Task.
- variableDispenser
- VariableDispenser
Eine Variables-Auflistung für den Task.
- events
- IDTSComponentEvents
Ein Verweis auf ein Objekt, das zum Auslösen von IDTSComponentEvents Ereignissen implementiert wird.
- log
- IDTSLogging
Ein Verweis auf ein Objekt, das IDTSLogging implementiert.
- transaction
- Object
Das Transaktionsobjekt, zu dem der Task gehört, abhängig vom Wert in der TransactionOption-Eigenschaft. Dieser Wert kann auf einen NULL-Verweis (Nothing in Visual Basic) festgelegt werden.
Gibt zurück
Ein DTSExecResult, das das Ergebnis der Ausführung angibt.
Beispiele
Im folgenden Codebeispiel wird gezeigt, wie Sie ein Paket ausführen, das ein BulkInsertTask Paket enthält, nachdem einige der Aufgabeneigenschaften festgelegt wurden. 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, dass sie geerbt und überschrieben werden soll, 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.