Process.RunAsync Метод

Определение

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

System.Diagnostics

Сборки:

netstandard.dll, System.Diagnostics.Process.dll

Перегрузки

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

RunAsync(ProcessStartInfo, CancellationToken)

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

Process.Scenarios.cs

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

[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static System.Threading.Tasks.Task<System.Diagnostics.ProcessExitStatus> RunAsync(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 RunAsync : System.Diagnostics.ProcessStartInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Diagnostics.ProcessExitStatus>

Public Shared Function RunAsync (startInfo As ProcessStartInfo, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ProcessExitStatus)

Параметры

startInfo

ProcessStartInfo

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

cancellationToken

CancellationToken

Маркер для отмены асинхронной операции. Если маркер отменен, процесс будет убит.

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

Task<ProcessExitStatus>

Задача, представляющая асинхронную операцию. Значение задачи содержит состояние выхода процесса. Если процесс убит из-за отмены, Canceled имеет значение true.

Атрибуты

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Исключения

ArgumentNullException

startInfo равно null.

InvalidOperationException

UseShellExecute задан как true.

–или–

RedirectStandardInput, RedirectStandardOutputили RedirectStandardError имеет значение true. Используйте соответствующие стандартные свойства дескриптора для предоставления дескрипторов.

RunAsync(String, IEnumerable<String>, Boolean, CancellationToken)

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

Process.Scenarios.cs

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

[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static System.Threading.Tasks.Task<System.Diagnostics.ProcessExitStatus> RunAsync(string fileName, System.Collections.Generic.IEnumerable<string>? arguments = default, bool silent = false, System.Threading.CancellationToken cancellationToken = default);

[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member RunAsync : string * seq<string> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Diagnostics.ProcessExitStatus>

Public Shared Function RunAsync (fileName As String, Optional arguments As IEnumerable(Of String) = Nothing, Optional silent As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ProcessExitStatus)

Параметры

fileName

String

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

arguments

IEnumerable<String>

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

silent

Boolean

При trueперенаправляет стандартные входные данные, выходные данные и ошибки на устройство NULL, обеспечивая отсутствие видимых выходных данных консоли. Когда falseпроцесс наследует стандартные дескрипторы от родительского элемента.

cancellationToken

CancellationToken

Маркер для отмены асинхронной операции. Если маркер отменен, процесс будет убит.

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

Task<ProcessExitStatus>

Задача, представляющая асинхронную операцию. Значение задачи содержит состояние выхода процесса. Если процесс убит из-за отмены, Canceled имеет значение true.

Атрибуты

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Исключения

ArgumentNullException

fileName равно null.

ArgumentException

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