ExecuteProcess Classe

Referência

Definição

Namespace:: Microsoft.SqlServer.Dts.Tasks.ExecuteProcess

Assembly:: Microsoft.SqlServer.ExecProcTask.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Executa um aplicativo ou arquivo em lotes como parte de um fluxo de trabalho de pacote. Essa classe não pode ser herdada.

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

Herança: Object

DtsObject

Task
ExecuteProcess

Atributos: DtsTaskAttribute GuidAttribute

Implementações: IDTSComponentPersist IDTSExecuteProcess

Comentários

Embora você possa usar a ExecuteProcess tarefa para abrir qualquer aplicativo padrão, como o Microsoft Excel ou o Microsoft Word, normalmente você a usa para executar aplicativos empresariais ou arquivos em lotes que funcionam em uma fonte de dados.

Construtores

ExecuteProcess()

Inicializa uma nova instância da classe ExecuteProcess.

Propriedades

Arguments	Obtém ou define os argumentos do prompt de comando. A cadeia de caracteres pode conter vários argumentos separados por um espaço.
Executable	Obtém ou define o nome do arquivo executável ou arquivo em lote do Microsoft Win32 a ser executado quando o pacote é executado.
ExecutionValue	Retorna um objeto definido pelo usuário. Esta propriedade é somente para leitura.
FailTaskIfReturnCodeIsNotSuccessValue	Obtém ou define um booliano que indica se a tarefa falha se o código de saída do processo for diferente do valor especificado em SuccessValue.
RequireFullFileName	Obtém ou define um booliano que indica se o nome completo e a extensão da tarefa são necessários.
StandardErrorVariable	Obtém ou define o nome da variável usado para capturar a saída de erro do processo a ser executado.
StandardInputVariable	Obtém ou define o nome da variável a ser usada como uma entrada para o processo a ser executado.
StandardOutputVariable	Obtém ou define o nome da variável usado para capturar a saída do processo a ser executado.
SuccessValue	Obtém ou define o valor retornado pelo executável ou arquivo em lotes que indica êxito.
TargetServerVersion	Executa um aplicativo ou arquivo em lotes como parte de um fluxo de trabalho de pacote. Essa classe não pode ser herdada. (Herdado de Task)
TerminateProcessAfterTimeOut	Obtém ou define um Boolean que indica se o processo é forçado a terminar após o período de tempo limite especificado pela TimeOut propriedade.
TimeOut	Obtém ou define o número de segundos que a tarefa permite que o processo seja executado.
Version	Membro preterido; consulte Comentários. *** Retorna a versão da tarefa. Esta propriedade é somente para leitura. (Herdado de Task)
WindowStyle	Obtém ou define o estilo da janela em que o processo será executado.
WorkingDirectory	Obtém ou define o diretório no qual os arquivos especificados na propriedade Arguments pode ser encontrados.

Métodos

CanUpdate(String)	Membro preterido; consulte Comentários. Um booliano que indica se o novo XML do pacote pode atualizar o XML do pacote antigo. (Herdado de Task)
Equals(Object)	Determina se duas instâncias de objeto são iguais. (Herdado de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Executa a tarefa.
GetConnectionID(Connections, String)	Obtém uma cadeia de caracteres que contém a ID da conexão. (Herdado de Task)
GetConnectionName(Connections, String)	Obtém uma cadeia de caracteres que contém o nome da conexão. (Herdado de Task)
GetHashCode()	Retorna o código hash para a instância. (Herdado de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Inicializa as propriedades associadas à tarefa. Esse método é chamado pelo runtime e não é usado em código.
LoadFromXML(XmlElement, IDTSInfoEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para carregar um pacote salvo como .xml, use o método LoadPackage(String, IDTSEvents).
SaveToXML(XmlDocument, IDTSInfoEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para salvar um pacote como .xml, use o método SaveToXml(String, Package, IDTSEvents).
Update(String)	Membro preterido; consulte Comentários. Esse método atualiza o XML do pacote antigo com o novo XML do pacote se CanUpdate(String) for definido como true. (Herdado de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Verifica se o componente foi configurado corretamente.

Aplica-se a