Freigeben über


ExecuteProcess Klasse

Definition

Führt eine Anwendung oder eine Batchdatei als Teil eines Paketworkflows 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 Sie die Aufgabe verwenden können, um eine beliebige Standardanwendung wie Microsoft Excel oder Microsoft Word zu öffnen, verwenden Sie diese in der ExecuteProcess Regel, um Geschäftsanwendungen oder Batchdateien auszuführen, die mit einer Datenquelle arbeiten.

Konstruktoren

ExecuteProcess()

Initialisiert eine neue Instanz der ExecuteProcess-Klasse.

Eigenschaften

Arguments

Ruft Befehlszeilenargumente ab oder legt sie fest. Die Zeichenfolge kann mehrere, durch ein Leerzeichen getrennte Argumente enthalten.

Executable

Ruft den Namen der ausführbaren Microsoft Win32-Datei oder Batchdatei ab, die ausgeführt werden soll, wenn das Paket ausgeführt wird, oder legt diesen fest.

ExecutionValue

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

FailTaskIfReturnCodeIsNotSuccessValue

Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, ob der Vorgang fehlschlägt, wenn der Prozessausgangscode vom in angegebenen SuccessValueWert unterscheidet.

RequireFullFileName

Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, ob der vollständige Name und die Erweiterung des Vorgangs erforderlich ist.

StandardErrorVariable

Ruft den Namen der Variablen ab, mit deren Hilfe die Fehlerausgabe des auszuführenden Prozesses erfasst wird, oder legt ihn fest.

StandardInputVariable

Ruft den Namen der Variablen ab, die als Eingabe für den auszuführenden Prozess verwendet wird, oder legt ihn fest.

StandardOutputVariable

Ruft den Namen der Variablen ab, mit deren Hilfe die Ausgabe des auszuführenden Prozesses erfasst wird, oder legt ihn fest.

SuccessValue

Ruft den Wert ab, der bei einer erfolgreichen Ausführung von der ausführbaren Datei oder Batchdatei zurückgegebenen wird, oder legt ihn fest.

TargetServerVersion

Führt eine Anwendung oder eine Batchdatei als Teil eines Paketworkflows aus. Diese Klasse kann nicht vererbt werden.

(Geerbt von Task)
TerminateProcessAfterTimeOut

Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, ob der Prozess nach dem durch die TimeOut Eigenschaft angegebenen Timeoutzeitraum beendet werden muss.

TimeOut

Ruft die Dauer in Sekunden ab, die der Task für die Prozessausführung vorsieht, oder legt sie fest.

Version

Mitglied veraltet; siehe Hinweise. *** Gibt die Version des Tasks zurück. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Task)
WindowStyle

Ruft die Fensteranordnung ab, in der der Prozess ausgeführt wird, oder legt sie fest.

WorkingDirectory

Ruft das Verzeichnis ab, in dem die in der Arguments-Eigenschaft angegebenen Dateien enthalten sind, oder legt es fest.

Methoden

CanUpdate(String)

Mitglied veraltet; siehe Hinweise. Ein boolescher Wert, der angibt, ob der neue Paket-XML-Code das alte Paket-XML aktualisieren kann.

(Geerbt von Task)
Equals(Object)

Stellt fest, ob zwei Objektinstanzen gleich sind.

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

Führt die Aufgabe aus.

GetConnectionID(Connections, String)

Ruft eine Zeichenfolge ab, die die ID der Verbindung enthält.

(Geerbt von Task)
GetConnectionName(Connections, String)

Ruft eine Zeichenfolge ab, die den Namen der Verbindung enthält.

(Geerbt von Task)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

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

Initialisiert die dem Task zugeordneten Eigenschaften. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet.

LoadFromXML(XmlElement, IDTSInfoEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode.

SaveToXML(XmlDocument, IDTSInfoEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode.

Update(String)

Mitglied veraltet; siehe Hinweise. Diese Methode aktualisiert den alten Paket-XML-Code mit dem neuen Paket-XML, wenn CanUpdate(String) er auf "true" festgelegt ist.

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

Überprüft, ob die Komponente ordnungsgemäß konfiguriert ist.

Gilt für: