Process.RunAndCaptureTextAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken) |
Inicia de forma asincrónica el proceso descrito por |
| RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken) |
Inicia de forma asincrónica un proceso con el nombre de archivo especificado y argumentos opcionales, captura su salida y error estándar, espera a que salga y devuelva el texto capturado y el estado de salida. |
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)
- Source:
- Process.Scenarios.cs
Inicia de forma asincrónica el proceso descrito por startInfo, captura su salida y error estándar, espera a que salga y devuelva el texto capturado y el estado de salida.
[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
ProcessStartInfo que contiene la información utilizada para iniciar el proceso.
- cancellationToken
- CancellationToken
Token para cancelar la operación asincrónica. Si se cancela el token, se elimina el proceso.
Devoluciones
Tarea que representa la operación asincrónica. El valor de la tarea contiene la salida de texto capturada y el estado de salida del proceso.
- Atributos
Excepciones
startInfo es null.
El valor de UseShellExecute está establecido en true.
– O bien –
RedirectStandardOutput o RedirectStandardError no está establecido en true.
cancellationToken Se canceló mientras se leen las secuencias redirigidas.
Comentarios
Si se produce la cancelación al leer las secuencias redirigidas, el método intenta eliminar el proceso y produce OperationCanceledException. Si la cancelación se produce después de que las secuencias se hayan leído por completo, pero mientras espera a que el proceso salga, el proceso se elimina y el devuelto ExitStatus se ha Canceled establecido en true.
Se aplica a
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)
- Source:
- Process.Scenarios.cs
Inicia de forma asincrónica un proceso con el nombre de archivo especificado y argumentos opcionales, captura su salida y error estándar, espera a que salga y devuelva el texto capturado y el estado de salida.
[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
Nombre del archivo ejecutable que se va a iniciar.
- arguments
- IEnumerable<String>
Argumentos de la línea de comandos que se van a pasar al proceso. Pase null o una secuencia vacía para iniciar el proceso sin argumentos adicionales.
- cancellationToken
- CancellationToken
Token para cancelar la operación asincrónica. Si se cancela el token, se elimina el proceso.
Devoluciones
Tarea que representa la operación asincrónica. El valor de la tarea contiene la salida de texto capturada y el estado de salida del proceso.
- Atributos
Excepciones
fileName es null.
fileName está vacío.
cancellationToken Se canceló mientras se leen las secuencias redirigidas.
Comentarios
Si se produce la cancelación al leer las secuencias redirigidas, el método intenta eliminar el proceso y produce OperationCanceledException. Si la cancelación se produce después de que las secuencias se hayan leído por completo, pero mientras espera a que el proceso salga, el proceso se elimina y el devuelto ExitStatus se ha Canceled establecido en true.
