Compartilhar via


System.Diagnostics.ProcessStartInfo.UseShellExecute propriedade

Este artigo fornece observações complementares à documentação de referência para essa API.

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

Definir a UseShellExecute propriedade para false permite redirecionar fluxos de entrada, saída e erro.

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

Observação

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

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

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 WorkingDirectory for uma cadeia de caracteres vazia, presume-se que o diretório atual contenha o executável.

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