Process.RunAndCaptureText 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 |
|---|---|
| RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>) |
Inicia um processo com o nome de ficheiro especificado e argumentos opcionais, captura a sua saída padrão e erro, espera que saia e retorna o texto capturado e o estado 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 de ficheiro especificado e argumentos opcionais, captura a sua saída padrão e erro, espera que saia e retorna 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.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 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.
O tempo máximo para esperar que o processo termine. Quando null, espera indefinidamente. Se o processo não sair dentro do tempo especificado, é cancelado.
Devoluções
A saída do texto capturado e o estado de saída do processo.
- Atributos
Exceções
timeout, truncado a um número inteiro de milissegundos, é menor que -1 ou maior que MaxValue.
fileName é null.
fileName está vazio.
Os fluxos redirecionados não eram totalmente lidos dentro do especificado timeout.
Observações
Se o timeout expirar enquanto se lê os fluxos redirecionados, o método tenta matar o processo e lança TimeoutException. Se os fluxos forem totalmente lidos mas o processo não sair dentro do tempo restante, o processo é encerrado e o retorno ExitStatus foi Canceled definido para true.
Aplica-se a
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)
- Origem:
- Process.Scenarios.cs
Inicia o processo descrito por startInfo, 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.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 a informação usada para iniciar o processo.
O tempo máximo para esperar que o processo termine. Quando null, espera indefinidamente. Se o processo não sair dentro do tempo especificado, é cancelado.
Devoluções
A saída do texto capturado e o estado de saída do processo.
- Atributos
Exceções
timeout, truncado a um número inteiro de milissegundos, é menor que -1 ou maior que MaxValue.
startInfo é null.
UseShellExecute está definido como true.
-ou-
RedirectStandardOutput ou RedirectStandardError não está definido como true.
Os fluxos redirecionados não eram totalmente lidos dentro do especificado timeout.
Observações
Se o timeout expirar enquanto se lê os fluxos redirecionados, o método tenta matar o processo e lança TimeoutException. Se os fluxos forem totalmente lidos mas o processo não sair dentro do tempo restante, o processo é encerrado e o retorno ExitStatus foi Canceled definido para true.
