Freigeben über


ExecuteProcess-Klasse

Runs an application or batch file as part of a package workflow. This class cannot be inherited.

Vererbungshierarchie

System.Object
  Microsoft.SqlServer.Dts.Runtime.DtsObject
    Microsoft.SqlServer.Dts.Runtime.Task
      Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.ExecuteProcess

Namespace:  Microsoft.SqlServer.Dts.Tasks.ExecuteProcess
Assembly:  Microsoft.SqlServer.ExecProcTask (in Microsoft.SqlServer.ExecProcTask.dll)

Syntax

'Declaration
<GuidAttribute("6BD3E0BE-DDDE-4305-95D5-5B52C6EEF84F")> _
Public NotInheritable Class ExecuteProcess _
    Inherits Task _
    Implements IDTSExecuteProcess, IDTSComponentPersist
'Usage
Dim instance As ExecuteProcess
[GuidAttribute("6BD3E0BE-DDDE-4305-95D5-5B52C6EEF84F")]
public sealed class ExecuteProcess : Task, 
    IDTSExecuteProcess, IDTSComponentPersist
[GuidAttribute(L"6BD3E0BE-DDDE-4305-95D5-5B52C6EEF84F")]
public ref class ExecuteProcess sealed : public Task, 
    IDTSExecuteProcess, IDTSComponentPersist
[<SealedAttribute>]
[<GuidAttribute("6BD3E0BE-DDDE-4305-95D5-5B52C6EEF84F")>]
type ExecuteProcess =  
    class 
        inherit Task 
        interface IDTSExecuteProcess 
        interface IDTSComponentPersist 
    end
public final class ExecuteProcess extends Task implements IDTSExecuteProcess, IDTSComponentPersist

Der ExecuteProcess-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode ExecuteProcess Initializes a new instance of the ExecuteProcess class.

Zum Anfang

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Arguments Gets or sets command prompt arguments. The string can contain multiple arguments separated by a space.
Öffentliche Eigenschaft Executable Gets or sets the name of the Microsoft Win32 executable file or batch file to run when the package runs.
Öffentliche Eigenschaft ExecutionValue Returns a user-defined object. This property is read-only. (Überschreibt Task.ExecutionValue.)
Öffentliche Eigenschaft FailTaskIfReturnCodeIsNotSuccessValue Gets or sets a Boolean that indicates whether the task fails if the process exit code is different from the value specified in SuccessValue.
Öffentliche Eigenschaft RequireFullFileName Gets or sets a Boolean that indicates whether the full name and extension of the task is required.
Öffentliche Eigenschaft StandardErrorVariable Gets or sets the name of the variable used to capture the error output of the process to be run.
Öffentliche Eigenschaft StandardInputVariable Gets or sets the name of the variable to be used as an input to the process to be run.
Öffentliche Eigenschaft StandardOutputVariable Gets or sets the name of the variable used to capture the output of the process to be run.
Öffentliche Eigenschaft SuccessValue Gets or sets the value returned by the executable or batch file that indicates success.
Öffentliche Eigenschaft TerminateProcessAfterTimeOut Gets or sets a Boolean that indicates whether the process is forced to end after the time-out period specified by the TimeOut property.
Öffentliche Eigenschaft TimeOut Gets or sets the number of seconds that the task allows the process to run.
Öffentliche Eigenschaft Version *** Member deprecated; see Remarks. ***    Returns the version of the task. This property is read-only. (Geerbt von Task.)
Öffentliche Eigenschaft WindowStyle Gets or sets the style of the window to run the process in.
Öffentliche Eigenschaft WorkingDirectory Gets or sets the directory in which the files specified in the Arguments property can be found.

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode CanUpdate *** Member deprecated; see Remarks. ***    A Boolean that indicates whether the new package XML can update the old package XML. (Geerbt von Task.)
Öffentliche Methode Equals Determines whether two object instances are equal. (Geerbt von DtsObject.)
Öffentliche Methode Execute Runs the task. (Überschreibt Task.Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object).)
Öffentliche Methode GetConnectionID Gets a String containing the ID of the connection. (Geerbt von Task.)
Öffentliche Methode GetConnectionName Gets a String containing the name of the connection. (Geerbt von Task.)
Öffentliche Methode GetHashCode Returns the hash code for this instance. (Geerbt von DtsObject.)
Öffentliche Methode GetType (Geerbt von Object.)
Öffentliche Methode InitializeTask Initializes the properties associated with the task. This method is called by the runtime and is not used in code. (Überschreibt Task.InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker).)
Öffentliche Methode LoadFromXML This method is not callable by your application code. To load a package saved as .xml, use the Application.LoadPackage method.
Öffentliche Methode SaveToXML This method is not callable by your application code. To save a package as .xml, use the Application.SaveToXml method.
Öffentliche Methode ToString (Geerbt von Object.)
Öffentliche Methode Update *** Member deprecated; see Remarks. ***    This method updates the old package XML with the new package XML if CanUpdate is set to true. (Geerbt von Task.)
Öffentliche Methode Validate Verifies that the component is properly configured. (Überschreibt Task.Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging).)

Zum Anfang

Hinweise

Although you can use the ExecuteProcess task to open any standard application, such as Microsoft Excel or Microsoft Word, you typically use it to run business applications or batch files that work against a data source.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

Microsoft.SqlServer.Dts.Tasks.ExecuteProcess-Namespace