ExecuteProcess Klasse

Definition

Führt eine Anwendung oder Batch-Datei als Teil eines Paket-Workflows aus. Diese Klasse kann nicht vererbt werden.

public ref class ExecuteProcess sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::ExecuteProcess::IDTSExecuteProcess
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executeprocesstask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.Localized), SamplesTag="SsisExecuteProcessTask", TaskContact="Execute Process Task;Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.ExecuteProcessUI, Microsoft.SqlServer.ExecProcTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("B3A79E82-6FC0-49F0-8C94-89D462AFEFF1")]
public sealed class ExecuteProcess : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.IDTSExecuteProcess
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executeprocesstask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.Localized), SamplesTag="SsisExecuteProcessTask", TaskContact="Execute Process Task;Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.ExecuteProcessUI, Microsoft.SqlServer.ExecProcTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("A2C0866D-F470-45DC-B742-FB4C3ADE88FE")]
public sealed class ExecuteProcess : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.IDTSExecuteProcess
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executeprocesstask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.Localized), SamplesTag="SsisExecuteProcessTask", TaskContact="Execute Process Task;Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.ExecuteProcessUI, Microsoft.SqlServer.ExecProcTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("A2BD6AA8-D7A6-4279-86A7-AD633D366B65")]
public sealed class ExecuteProcess : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.IDTSExecuteProcess
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executeprocesstask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.Localized), SamplesTag="SsisExecuteProcessTask", TaskContact="Execute Process Task;Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.ExecuteProcessUI, Microsoft.SqlServer.ExecProcTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("B3A79E82-6FC0-49F0-8C94-89D462AFEFF1")>]
type ExecuteProcess = class
    inherit Task
    interface IDTSExecuteProcess
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executeprocesstask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.Localized), SamplesTag="SsisExecuteProcessTask", TaskContact="Execute Process Task;Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.ExecuteProcessUI, Microsoft.SqlServer.ExecProcTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("A2C0866D-F470-45DC-B742-FB4C3ADE88FE")>]
type ExecuteProcess = class
    inherit Task
    interface IDTSExecuteProcess
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executeprocesstask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.Localized), SamplesTag="SsisExecuteProcessTask", TaskContact="Execute Process Task;Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.ExecuteProcessUI, Microsoft.SqlServer.ExecProcTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("A2BD6AA8-D7A6-4279-86A7-AD633D366B65")>]
type ExecuteProcess = class
    inherit Task
    interface IDTSExecuteProcess
    interface IDTSComponentPersist
Public NotInheritable Class ExecuteProcess
Inherits Task
Implements IDTSComponentPersist, IDTSExecuteProcess
Vererbung
ExecuteProcess
Attribute
Implementiert

Hinweise

Obwohl man die ExecuteProcess Aufgabe nutzen kann, um jede Standardanwendung wie Microsoft Excel oder Microsoft Word zu öffnen, nutzt man sie in der Regel, um Geschäftsanwendungen oder Batchdateien auszuführen, die gegen eine Datenquelle arbeiten.

Konstruktoren

Name Beschreibung
ExecuteProcess()

Initialisiert eine neue Instanz der ExecuteProcess-Klasse.

Eigenschaften

Name Beschreibung
Arguments

Erhält oder setzt Eingabeaufforderungsargumente. Die Zeichenkette kann mehrere Argumente enthalten, die durch ein Leerzeichen getrennt sind.

Executable

Er erhält oder setzt den Namen der Microsoft Win32-ausführbaren Datei oder Batchdatei so, dass er beim Ausführen des Pakets ausgeführt wird.

ExecutionValue

Gibt ein benutzerdefiniertes Objekt zurück. Diese Eigenschaft ist schreibgeschützt.

FailTaskIfReturnCodeIsNotSuccessValue

Erhält oder setzt einen Boolean, der anzeigt, ob die Aufgabe fehlschlägt, wenn der Prozess-Exitcode vom in angegebenen SuccessValueWert abweicht.

RequireFullFileName

Erhält oder setzt ein boolsches System, das angibt, ob der vollständige Name und die Erweiterung der Aufgabe erforderlich sind.

StandardErrorVariable

Erhält oder setzt den Namen der Variablen, die zur Erfassung der Fehlerausgabe des auszuführenden Prozesses verwendet wird.

StandardInputVariable

Erhält oder setzt den Namen der Variable, die als Eingabe für den auszuführenden Prozess verwendet werden soll.

StandardOutputVariable

Erhält oder setzt den Namen der Variable, die zur Erfassung der Ausgabe des auszuführenden Prozesses verwendet wird.

SuccessValue

Erhält oder setzt den von der ausführbaren Datei oder der Batch-Datei zurückgegebenen Wert, der den Erfolg anzeigt.

TargetServerVersion

Führt eine Anwendung oder Batch-Datei als Teil eines Paket-Workflows aus. Diese Klasse kann nicht vererbt werden.

(Geerbt von Task)
TerminateProcessAfterTimeOut

Erhält oder setzt einen Booleschen Bereich, der angibt, ob der Prozess nach dem von der Eigenschaft TimeOut angegebenen Zeitablauf beendet wird.

TimeOut

Erhält oder setzt die Anzahl der Sekunden, die die Aufgabe dem Prozess zulässt.

Version

Mitglied veraltet; siehe Bemerkungen. Gibt die Version der Aufgabe zurück. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Task)
WindowStyle

Erhält oder setzt den Stil des Fensters, in dem der Prozess ausgeführt wird.

WorkingDirectory

Erhält oder setzt das Verzeichnis, in dem die in der Eigenschaft Arguments angegebenen Dateien gefunden werden können.

Methoden

Name Beschreibung
CanUpdate(String)

Mitglied veraltet; siehe Bemerkungen. Ein Boolesche Bereich, der angibt, ob das neue Paket-XML das alte Paket-XML aktualisieren kann.

(Geerbt von Task)
Equals(Object)

Bestimmt, ob zwei Objektinstanzen gleich sind.

(Geerbt von DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Führt die Aufgabe aus.

GetConnectionID(Connections, String)

Erhält einen String, der die ID der Verbindung enthält.

(Geerbt von Task)
GetConnectionName(Connections, String)

Erhält eine Zeichenkette, die den Namen der Verbindung enthält.

(Geerbt von Task)
GetHashCode()

Gibt den Hashcode für diesen instance zurück.

(Geerbt von DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

Initialisiert die mit der Aufgabe verbundenen Eigenschaften. Diese Methode wird von der Laufzeit aufgerufen und im Code nicht verwendet.

LoadFromXML(XmlElement, IDTSInfoEvents)

Diese Methode kann von deinem Anwendungscode nicht aufgerufen werden. Um ein als .xmlgespeichertes Paket zu laden, verwenden Sie die Methode LoadPackage(String, IDTSEvents) .

SaveToXML(XmlDocument, IDTSInfoEvents)

Diese Methode kann von deinem Anwendungscode nicht aufgerufen werden. Um ein Paket als .xmlzu speichern, verwenden Sie die Methode SaveToXml(String, Package, IDTSEvents) .

Update(String)

Mitglied veraltet; siehe Bemerkungen. Diese Methode aktualisiert das alte Paket XML mit dem neuen Paket XML, wenn CanUpdate(String) auf true gesetzt ist.

(Geerbt von Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Überprüft, ob die Komponente korrekt konfiguriert ist.

Gilt für: