Process.RunAndCaptureText Метод

Определение

Пространство имен:

System.Diagnostics

Сборки:

netstandard.dll, System.Diagnostics.Process.dll

Перегрузки

Имя.	Описание
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)	Запускает процесс с указанным именем файла и необязательными аргументами, записывает стандартные выходные данные и ошибку, ожидает выхода и возвращает захваченный текст и состояние выхода.
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)	Запускает процесс, описанный в startInfoразделе , записывает стандартные выходные данные и ошибки, ожидает выхода и возвращает захваченный текст и состояние выхода.

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

Исходный код:

Process.Scenarios.cs

Запускает процесс с указанным именем файла и необязательными аргументами, записывает стандартные выходные данные и ошибку, ожидает выхода и возвращает захваченный текст и состояние выхода.

[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

Параметры

fileName

String

Имя запускаемого исполняемого файла.

arguments

IEnumerable<String>

Аргументы командной строки для передачи в процесс. Передайте null или пустую последовательность, чтобы запустить процесс без дополнительных аргументов.

timeout

Nullable<TimeSpan>

Максимальное время ожидания завершения процесса. Когда null, ожидается неограниченное время. Если процесс не завершается в течение указанного времени ожидания, он будет убит.

Возвращаемое значение

ProcessTextOutput

Захваченные текстовые выходные данные и состояние выхода процесса.

Атрибуты

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Исключения

ArgumentOutOfRangeException

timeout, усеченный до целого числа миллисекунда, меньше -1 или больше MaxValue.

ArgumentNullException

fileName равно null.

ArgumentException

fileName значение пусто.

TimeoutException

Перенаправленные потоки не были полностью считываются в указанных timeout.

Комментарии

Если истекает время ожидания при чтении перенаправленных потоков, метод пытается убить процесс и вызывает исключение TimeoutException. Если потоки были полностью считываются, но процесс не завершается в течение оставшегося времени ожидания, процесс будет убит и возвращено ExitStatusCanceled значение true.

RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)

Исходный код:

Process.Scenarios.cs

Запускает процесс, описанный в startInfoразделе , записывает стандартные выходные данные и ошибки, ожидает выхода и возвращает захваченный текст и состояние выхода.

[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

Параметры

startInfo

ProcessStartInfo

Содержит ProcessStartInfo сведения, используемые для запуска процесса.

timeout

Nullable<TimeSpan>

Максимальное время ожидания завершения процесса. Когда null, ожидается неограниченное время. Если процесс не завершается в течение указанного времени ожидания, он будет убит.

Возвращаемое значение

ProcessTextOutput

Захваченные текстовые выходные данные и состояние выхода процесса.

Атрибуты

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Исключения

ArgumentOutOfRangeException

timeout, усеченный до целого числа миллисекунда, меньше -1 или больше MaxValue.

ArgumentNullException

startInfo равно null.

InvalidOperationException

UseShellExecute задан как true.

–или–

RedirectStandardOutput или RedirectStandardError не задано значение true.

TimeoutException

Перенаправленные потоки не были полностью считываются в указанных timeout.

Комментарии

Если истекает время ожидания при чтении перенаправленных потоков, метод пытается убить процесс и вызывает исключение TimeoutException. Если потоки были полностью считываются, но процесс не завершается в течение оставшегося времени ожидания, процесс будет убит и возвращено ExitStatusCanceled значение true.