Process.RunAndCaptureTextAsync Método

Definição

Namespace:

System.Diagnostics

Assemblies:

netstandard.dll, System.Diagnostics.Process.dll

Sobrecargas

Nome	Description
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)	Inicia de forma assíncrona o processo descrito por startInfo, captura sua saída e erro padrão, aguarda a saída e retorna o status de saída e texto capturado.
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)	Inicia de forma assíncrona um processo com o nome do arquivo especificado e argumentos opcionais, captura sua saída e erro padrão, aguarda que ele saia e retorna o texto capturado e o status de saída.

RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)

Origem:

Process.Scenarios.cs

Inicia de forma assíncrona o processo descrito por startInfo, captura sua saída e erro padrão, aguarda a saída e retorna o status de saída e texto capturado.

[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static System.Threading.Tasks.Task<System.Diagnostics.ProcessTextOutput> RunAndCaptureTextAsync(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 RunAndCaptureTextAsync : System.Diagnostics.ProcessStartInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Diagnostics.ProcessTextOutput>

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

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<ProcessTextOutput>

Uma tarefa que representa a operação assíncrona. O valor da tarefa contém a saída de texto capturada e o status de saída do processo.

Atributos

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceções

ArgumentNullException

startInfo é null.

InvalidOperationException

UseShellExecute é definido como true.

- ou -

RedirectStandardOutput ou RedirectStandardError não está definido como true.

OperationCanceledException

O cancellationToken foi cancelado durante a leitura dos fluxos redirecionados.

Comentários

Se o cancelamento ocorrer durante a leitura dos fluxos redirecionados, o método tentará eliminar o processo e gerará OperationCanceledException. Se o cancelamento ocorrer após os fluxos terem sido totalmente lidos, mas enquanto aguarda o processo ser encerrado, o processo será encerrado e o retornado ExitStatus será Canceled definido como true.

RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)

Origem:

Process.Scenarios.cs

Inicia de forma assíncrona um processo com o nome do arquivo especificado e argumentos opcionais, captura sua saída e erro padrão, aguarda que ele saia e retorna o texto capturado e o 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.ProcessTextOutput> RunAndCaptureTextAsync(string fileName, System.Collections.Generic.IEnumerable<string>? arguments = default, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function RunAndCaptureTextAsync (fileName As String, Optional arguments As IEnumerable(Of String) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ProcessTextOutput)

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.

cancellationToken

CancellationToken

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

Retornos

Task<ProcessTextOutput>

Uma tarefa que representa a operação assíncrona. O valor da tarefa contém a saída de texto capturada e o status de saída do processo.

Atributos

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceções

ArgumentNullException

fileName é null.

ArgumentException

fileName está vazio.

OperationCanceledException

O cancellationToken foi cancelado durante a leitura dos fluxos redirecionados.

Comentários

Se o cancelamento ocorrer durante a leitura dos fluxos redirecionados, o método tentará eliminar o processo e gerará OperationCanceledException. Se o cancelamento ocorrer após os fluxos terem sido totalmente lidos, mas enquanto aguarda o processo ser encerrado, o processo será encerrado e o retornado ExitStatus será Canceled definido como true.