Propriedade System.Diagnostics.ProcessStartInfo.UseShellExecute

Este artigo fornece comentários complementares à documentação de referência para esta API.

A ProcessStartInfo classe especifica um conjunto de valores que são usados quando você inicia um processo.

A definição da propriedade UseShellExecute para false permite redirecionar os fluxos de entrada, saída e erro.

A palavra "shell" neste contexto (UseShellExecute) refere-se a um shell gráfico (semelhante ao shell do Windows) em vez de shells de comando (por exemplo, bash ou sh) e permite que os usuários iniciem aplicativos gráficos ou documentos abertos.

Observação

UseShellExecute deve ser false se a propriedade UserName não seja null ou uma cadeia de caracteres vazia, ou uma InvalidOperationException será gerada quando o método Process.Start(ProcessStartInfo) for chamado.

Ao usar o shell do sistema operacional para iniciar processos, você pode iniciar qualquer documento (que seja qualquer tipo de arquivo registrado associado a um executável que tenha uma ação aberta padrão) e executar operações no arquivo, como impressão, usando o Process objeto. Quando UseShellExecute for false, você poderá iniciar apenas executáveis usando objeto Process.

Observação

UseShellExecute deve ser true se você definir a ErrorDialog propriedade como true.

WorkingDirectory

A WorkingDirectory propriedade se comporta de forma diferente dependendo do valor da UseShellExecute propriedade. Quando UseShellExecute é true, a WorkingDirectory propriedade especifica o local do executável. Se for uma cadeia de caracteres vazia, supõe-se WorkingDirectory que o diretório atual contenha o executável.

Quando UseShellExecute for false, a propriedade WorkingDirectory não será usada para localizar o executável. Em vez disso, ele é usado apenas pelo processo iniciado e tem significado somente dentro do contexto do novo processo. Quando UseShellExecute for false, a propriedade FileName poderá ser um caminho completo para o executável ou um nome simples do executável que o sistema tentará encontrar dentro das pastas especificadas pela variável de ambiente PATH. A interpretação do caminho de pesquisa depende do sistema operacional. Para obter mais informações, insira HELP PATH ou man sh em um prompt de comando.