Process.RunAndCaptureText Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblados:

netstandard.dll, System.Diagnostics.Process.dll

Sobrecargas

Nombre	Description
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)	Inicia 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.
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)	Inicia 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.

RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)

Source:

Process.Scenarios.cs

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

Public Shared Function RunAndCaptureText (fileName As String, Optional arguments As IEnumerable(Of String) = Nothing, Optional timeout As Nullable(Of TimeSpan) = Nothing) As 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.

timeout

Nullable<TimeSpan>

Cantidad máxima de tiempo que se va a esperar a que se cierre el proceso. Cuando null, espera indefinidamente. Si el proceso no sale dentro del tiempo de espera especificado, se elimina.

Devoluciones

ProcessTextOutput

Salida de texto capturado y estado de salida del proceso.

Atributos

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Excepciones

ArgumentOutOfRangeException

timeout, truncado a un número entero de milisegundos, es menor que -1 o mayor que MaxValue.

ArgumentNullException

fileName es null.

ArgumentException

fileName está vacío.

TimeoutException

Las secuencias redirigidas no se leyeron completamente dentro del especificado timeout.

Comentarios

Si el tiempo de espera expira mientras lee las secuencias redirigidas, el método intenta eliminar el proceso e inicia TimeoutException. Si las secuencias se han leído completamente, pero el proceso no sale dentro del tiempo de espera restante, el proceso se elimina y el devuelto ExitStatus se ha Canceled establecido en true.

RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)

Source:

Process.Scenarios.cs

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

Public Shared Function RunAndCaptureText (startInfo As ProcessStartInfo, Optional timeout As Nullable(Of TimeSpan) = Nothing) As ProcessTextOutput

Parámetros

startInfo

ProcessStartInfo

ProcessStartInfo que contiene la información utilizada para iniciar el proceso.

timeout

Nullable<TimeSpan>

Cantidad máxima de tiempo que se va a esperar a que se cierre el proceso. Cuando null, espera indefinidamente. Si el proceso no sale dentro del tiempo de espera especificado, se elimina.

Devoluciones

ProcessTextOutput

Salida de texto capturado y estado de salida del proceso.

Atributos

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Excepciones

ArgumentOutOfRangeException

timeout, truncado a un número entero de milisegundos, es menor que -1 o mayor que MaxValue.

ArgumentNullException

startInfo es null.

InvalidOperationException

El valor de UseShellExecute está establecido en true.

– O bien –

RedirectStandardOutput o RedirectStandardError no está establecido en true.

TimeoutException

Las secuencias redirigidas no se leyeron completamente dentro del especificado timeout.

Comentarios

Si el tiempo de espera expira mientras lee las secuencias redirigidas, el método intenta eliminar el proceso e inicia TimeoutException. Si las secuencias se han leído completamente, pero el proceso no sale dentro del tiempo de espera restante, el proceso se elimina y el devuelto ExitStatus se ha Canceled establecido en true.