Process.RunAsync Método

Definição

Namespace:: System.Diagnostics

Assemblies:: netstandard.dll, System.Diagnostics.Process.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.

Sobrecargas

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

RunAsync(ProcessStartInfo, CancellationToken)

Origem:: Process.Scenarios.cs

Inicia de forma assíncrona 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.Threading.Tasks.Task<System.Diagnostics.ProcessExitStatus> RunAsync(System.Diagnostics.ProcessStartInfo startInfo, System.Threading.CancellationToken cancellationToken = default);

[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member RunAsync : System.Diagnostics.ProcessStartInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Diagnostics.ProcessExitStatus>

Public Shared Function RunAsync (startInfo As ProcessStartInfo, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ProcessExitStatus)

Parâmetros

startInfo: ProcessStartInfo

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

cancellationToken: CancellationToken

Um token para cancelar a operação assíncrona. Se o token for cancelado, o processo será encerrado.

Retornos

Task<ProcessExitStatus>

Uma tarefa que representa a operação assíncrona. O valor da tarefa contém o status de saída do processo. Se o processo for encerrado devido ao cancelamento, Canceled será true.

Atributos: SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceções

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.

Aplica-se a

RunAsync(String, IEnumerable<String>, Boolean, CancellationToken)

Origem:: Process.Scenarios.cs

Inicia de forma assíncrona 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.Threading.Tasks.Task<System.Diagnostics.ProcessExitStatus> RunAsync(string fileName, System.Collections.Generic.IEnumerable<string>? arguments = default, bool silent = false, System.Threading.CancellationToken cancellationToken = default);

[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member RunAsync : string * seq<string> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Diagnostics.ProcessExitStatus>

Public Shared Function RunAsync (fileName As String, Optional arguments As IEnumerable(Of String) = Nothing, Optional silent As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of 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.

cancellationToken: CancellationToken

Um token para cancelar a operação assíncrona. Se o token for cancelado, o processo será encerrado.

Retornos

Task<ProcessExitStatus>

Uma tarefa que representa a operação assíncrona. O valor da tarefa contém o status de saída do processo. Se o processo for encerrado devido ao cancelamento, Canceled será true.

Atributos: SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceções

ArgumentNullException

fileName é null.

ArgumentException

fileName está vazio.

Aplica-se a

Comentários

Esta página foi útil?