Process.RunAndCaptureText Método
Definição
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 |
|---|---|
| RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>) |
Inicia 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. |
| RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>) |
Inicia o processo descrito por |
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)
- Origem:
- Process.Scenarios.cs
Inicia 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.Diagnostics.ProcessTextOutput RunAndCaptureText(string fileName, System.Collections.Generic.IEnumerable<string>? arguments = default, TimeSpan? timeout = default);[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member RunAndCaptureText : string * seq<string> * Nullable<TimeSpan> -> System.Diagnostics.ProcessTextOutputPublic Shared Function RunAndCaptureText (fileName As String, Optional arguments As IEnumerable(Of String) = Nothing, Optional timeout As Nullable(Of TimeSpan) = Nothing) As ProcessTextOutputParâ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.
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
A saída de texto capturada e o status de saída do processo.
- Atributos
Exceções
timeout, truncado para um número inteiro de milissegundos, é menor que -1 ou maior que MaxValue.
fileName é null.
fileName está vazio.
Os fluxos redirecionados não foram totalmente lidos dentro do especificado timeout.
Comentários
Se o tempo limite expirar durante a leitura dos fluxos redirecionados, o método tentará eliminar o processo e gerará TimeoutException. Se os fluxos tiverem sido totalmente lidos, mas o processo não sair dentro do tempo limite restante, o processo será encerrado e o retornado ExitStatus será Canceled definido como true.
Aplica-se a
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)
- Origem:
- Process.Scenarios.cs
Inicia o processo descrito por startInfo, 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.Diagnostics.ProcessTextOutput RunAndCaptureText(System.Diagnostics.ProcessStartInfo startInfo, TimeSpan? timeout = default);[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member RunAndCaptureText : System.Diagnostics.ProcessStartInfo * Nullable<TimeSpan> -> System.Diagnostics.ProcessTextOutputPublic Shared Function RunAndCaptureText (startInfo As ProcessStartInfo, Optional timeout As Nullable(Of TimeSpan) = Nothing) As ProcessTextOutputParâmetros
- startInfo
- ProcessStartInfo
O ProcessStartInfo que contém as informações usadas para iniciar o processo.
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
A saída de texto capturada e o status de saída do processo.
- Atributos
Exceções
timeout, truncado para um número inteiro de milissegundos, é menor que -1 ou maior que MaxValue.
startInfo é null.
UseShellExecute é definido como true.
- ou -
RedirectStandardOutput ou RedirectStandardError não está definido como true.
Os fluxos redirecionados não foram totalmente lidos dentro do especificado timeout.
Comentários
Se o tempo limite expirar durante a leitura dos fluxos redirecionados, o método tentará eliminar o processo e gerará TimeoutException. Se os fluxos tiverem sido totalmente lidos, mas o processo não sair dentro do tempo limite restante, o processo será encerrado e o retornado ExitStatus será Canceled definido como true.
