Process.RunAndCaptureTextAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Nome | Descrição |
|---|---|
| RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken) |
Inicia assíncronamente o processo descrito por |
| RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken) |
O processo inicia assíncronamente com o nome do ficheiro especificado e argumentos opcionais, captura a sua saída padrão e erro, espera que saia e devolve o texto capturado e o estado de saída. |
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)
- Origem:
- Process.Scenarios.cs
Inicia assíncronamente o processo descrito por startInfo, captura a sua saída padrão e erro, espera que este saia e devolve o texto capturado e o estado 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(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 a informação usada para iniciar o processo.
- cancellationToken
- CancellationToken
Um token para cancelar a operação assíncrona. Se o token for cancelado, o processo é interrompido.
Devoluções
Uma tarefa que representa a operação assíncrona. O valor da tarefa contém a saída de texto capturada e o estado de saída do processo.
- Atributos
Exceções
startInfo é null.
UseShellExecute está definido como true.
-ou-
RedirectStandardOutput ou RedirectStandardError não está definido como true.
Foi cancellationToken cancelado enquanto lia as transmissões redirecionadas.
Observações
Se o cancelamento ocorrer durante a leitura dos fluxos redirecionados, o método tenta matar o processo e lança OperationCanceledException. Se o cancelamento ocorrer depois de os fluxos terem sido totalmente lidos, mas enquanto se espera que o processo saia, o processo é encerrado e o retorno ExitStatus foi Canceled definido para true.
Aplica-se a
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)
- Origem:
- Process.Scenarios.cs
O processo inicia assíncronamente com o nome do ficheiro especificado e argumentos opcionais, captura a sua saída padrão e erro, espera que saia e devolve o texto capturado e o estado 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 para começar.
- arguments
- IEnumerable<String>
Os argumentos da linha de comandos para passar ao processo. Passe null ou faça 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 é interrompido.
Devoluções
Uma tarefa que representa a operação assíncrona. O valor da tarefa contém a saída de texto capturada e o estado de saída do processo.
- Atributos
Exceções
fileName é null.
fileName está vazio.
Foi cancellationToken cancelado enquanto lia as transmissões redirecionadas.
Observações
Se o cancelamento ocorrer durante a leitura dos fluxos redirecionados, o método tenta matar o processo e lança OperationCanceledException. Se o cancelamento ocorrer depois de os fluxos terem sido totalmente lidos, mas enquanto se espera que o processo saia, o processo é encerrado e o retorno ExitStatus foi Canceled definido para true.
