Partager via


Classe ExecuteProcess

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

Hiérarchie d'héritage

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

Espace de noms :  Microsoft.SqlServer.Dts.Tasks.ExecuteProcess
Assembly :  Microsoft.SqlServer.ExecProcTask (en Microsoft.SqlServer.ExecProcTask.dll)

Syntaxe

'Déclaration
<GuidAttribute("730F5F89-3336-4568-B2D1-7E8A26E2796F")> _
Public NotInheritable Class ExecuteProcess _
    Inherits Task _
    Implements IDTSExecuteProcess, IDTSComponentPersist
'Utilisation
Dim instance As ExecuteProcess
[GuidAttribute("730F5F89-3336-4568-B2D1-7E8A26E2796F")]
public sealed class ExecuteProcess : Task, 
    IDTSExecuteProcess, IDTSComponentPersist
[GuidAttribute(L"730F5F89-3336-4568-B2D1-7E8A26E2796F")]
public ref class ExecuteProcess sealed : public Task, 
    IDTSExecuteProcess, IDTSComponentPersist
[<SealedAttribute>]
[<GuidAttribute("730F5F89-3336-4568-B2D1-7E8A26E2796F")>]
type ExecuteProcess =  
    class
        inherit Task
        interface IDTSExecuteProcess
        interface IDTSComponentPersist
    end
public final class ExecuteProcess extends Task implements IDTSExecuteProcess, IDTSComponentPersist

Le type ExecuteProcess expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique ExecuteProcess Initializes a new instance of the ExecuteProcess class.

Haut de la page

Propriétés

  Nom Description
Propriété publique Arguments Gets or sets command prompt arguments. The string can contain multiple arguments separated by a space.
Propriété publique Executable Gets or sets the name of the Microsoft Win32 executable file or batch file to run when the package runs.
Propriété publique ExecutionValue Returns a user-defined object. This property is read-only. (remplace Task. . :: . .ExecutionValue.)
Propriété publique 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.
Propriété publique RequireFullFileName Gets or sets a Boolean that indicates whether the full name and extension of the task is required.
Propriété publique StandardErrorVariable Gets or sets the name of the variable used to capture the error output of the process to be run.
Propriété publique StandardInputVariable Gets or sets the name of the variable to be used as an input to the process to be run.
Propriété publique StandardOutputVariable Gets or sets the name of the variable used to capture the output of the process to be run.
Propriété publique SuccessValue Gets or sets the value returned by the executable or batch file that indicates success.
Propriété publique 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.
Propriété publique TimeOut Gets or sets the number of seconds that the task allows the process to run.
Propriété publique Version *** Member deprecated; see Remarks. ***    Returns the version of the task. This property is read-only. (hérité de Task.)
Propriété publique WindowStyle Gets or sets the style of the window to run the process in.
Propriété publique WorkingDirectory Gets or sets the directory in which the files specified in the Arguments property can be found.

Haut de la page

Méthodes

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

Haut de la page

Notes

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.

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.