ExecuteProcess Klasse
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 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
- 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. |