Process.Run Método

Definição

Namespace:

System.Diagnostics

Assemblies:

netstandard.dll, System.Diagnostics.Process.dll

Sobrecargas

Nome	Description
Run(ProcessStartInfo, Nullable<TimeSpan>)	Inicia o processo descrito por startInfo, aguarda que ele saia e retorna seu status de saída.
Run(String, IEnumerable<String>, Boolean, Nullable<TimeSpan>)	Inicia um processo com o nome do arquivo especificado e argumentos opcionais, aguarda a saída dele e retorna seu status de saída.

Run(ProcessStartInfo, Nullable<TimeSpan>)

Origem:

Process.Scenarios.cs

Inicia o processo descrito por startInfo, aguarda que ele saia e retorna seu status de saída.

[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static System.Diagnostics.ProcessExitStatus Run(System.Diagnostics.ProcessStartInfo startInfo, TimeSpan? timeout = default);

[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member Run : System.Diagnostics.ProcessStartInfo * Nullable<TimeSpan> -> System.Diagnostics.ProcessExitStatus

Public Shared Function Run (startInfo As ProcessStartInfo, Optional timeout As Nullable(Of TimeSpan) = Nothing) As ProcessExitStatus

Parâmetros

startInfo

ProcessStartInfo

O ProcessStartInfo que contém as informações usadas para iniciar o processo.

timeout

Nullable<TimeSpan>

O tempo máximo para aguardar a saída do processo. Quando null, aguarda indefinidamente. Se o processo não sair dentro do tempo limite especificado, ele será encerrado.

Retornos

ProcessExitStatus

O status de saída do processo. Se o processo for encerrado devido ao tempo limite, Canceled será true.

Atributos

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceções

ArgumentOutOfRangeException

timeout, truncado para um número inteiro de milissegundos, é menor que -1 ou maior que MaxValue.

ArgumentNullException

startInfo é null.

InvalidOperationException

UseShellExecute é definido como true.

- ou -

RedirectStandardInput, RedirectStandardOutputou RedirectStandardError está definido como true. Use as propriedades de identificador padrão correspondentes para fornecer identificadores.

Run(String, IEnumerable<String>, Boolean, Nullable<TimeSpan>)

Origem:

Process.Scenarios.cs

Inicia um processo com o nome do arquivo especificado e argumentos opcionais, aguarda a saída dele e retorna seu status de saída.

[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static System.Diagnostics.ProcessExitStatus Run(string fileName, System.Collections.Generic.IEnumerable<string>? arguments = default, bool silent = false, TimeSpan? timeout = default);

[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member Run : string * seq<string> * bool * Nullable<TimeSpan> -> System.Diagnostics.ProcessExitStatus

Public Shared Function Run (fileName As String, Optional arguments As IEnumerable(Of String) = Nothing, Optional silent As Boolean = false, Optional timeout As Nullable(Of TimeSpan) = Nothing) As ProcessExitStatus

Parâmetros

fileName

String

O nome do executável a ser iniciado.

arguments

IEnumerable<String>

Os argumentos de linha de comando a serem passados para o processo. Passe null ou uma sequência vazia para iniciar o processo sem argumentos adicionais.

silent

Boolean

Quando true, redireciona a entrada, a saída e o erro padrão para o dispositivo nulo, garantindo que o processo não produza nenhuma saída de console visível. Quando false, o processo herda identificadores padrão do pai.

timeout

Nullable<TimeSpan>

O tempo máximo para aguardar a saída do processo. Quando null, aguarda indefinidamente. Se o processo não sair dentro do tempo limite especificado, ele será encerrado.

Retornos

ProcessExitStatus

O status de saída do processo. Se o processo for encerrado devido ao tempo limite, Canceled será true.

Atributos

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceções

ArgumentOutOfRangeException

timeout, truncado para um número inteiro de milissegundos, é menor que -1 ou maior que MaxValue.

ArgumentNullException

fileName é null.

ArgumentException

fileName está vazio.