TransferErrorMessagesTask.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 als Teil eines Paket-Workflows 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
Die Sammlung Connections für den Behälter.
- variableDispenser
- VariableDispenser
Die Sammlung Variables für den Behälter.
- events
- IDTSComponentEvents
Eine Schnittstelle IDTSComponentEvents , um Ereignisse anzusprechen.
- log
- IDTSLogging
Eine IDTSLogging-Schnittstelle.
- transaction
- Object
Das Transaktionsobjekt, zu dem der Container gehört, abhängig vom in der Eigenschaft TransactionOption gefundenen Wert. Dieser Wert kann NULL sein.
Gibt zurück
Eine DTSExecResult Aufzählung, die das Ergebnis der Hinrichtung anzeigt.
Beispiele
Das folgende Codebeispiel zeigt, wie man ein Paket ausführt, das von EventsProvidererbt, das wiederum von erbt DtsContainer. Das Paket enthält ein BulkInsertTask. Die Aufgabe Bulk Insert wird nur als Beispiel verwendet; jede Aufgabe kann an ihrer Stelle 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 package execution.
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 package execution.
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 Methode Execute wird von Objekten übernommen und wird im Code nicht häufig verwendet; es wird empfohlen, die Execute Methode aufzurufen, wenn Sie Aufgaben oder Container im Paket ausführen müssen. Die Methode Execute ist jedoch bei einzelnen Objekten verfügbar, falls Sie eine besondere Situation finden, in der sie benötigt wird.
Der Hauptzweck der Methode Execute besteht darin, dass sie geerbt und überschrieben wird, wenn man eine benutzerdefinierte Aufgabe erstellt. Für weitere Informationen darüber, wie man die Execute-Methode überschreibt, siehe Coding a Custom Task.
Die Methode Execute ruft die Methode Validate implizit auf, bevor das Paket ausgeführt wird. Alle Aufgaben im Paket und alle Objekte im Paket werden während der Validierung auf geeignete Einstellungen überprüft, einschließlich des Pakets, der Container und anderer Komponenten im Paket.
Wenn in der Validierungsphase keine Probleme auftreten, die zum Fehlschlagen des Pakets führen würden, ruft das Paketobjekt die Methode Execute für jede Aufgabe und jedes Objekt im Paket auf.
Für den null Parameter gilttransaction, wenn die Eigenschaft TransactionOption istfalse. Wenn die Eigenschaft TransactionOption lautettrue, kannst du den Parameter transaction eingebennull, um anzuzeigen, dass der Container Transaktionen unterstützt, aber nicht teilnehmen wird.