Language

Process.RunAndCaptureTextAsync メソッド

定義

オーバーロード

Name 説明
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)

startInfoによって記述されたプロセスを非同期的に開始し、標準の出力とエラーをキャプチャし、終了するまで待機して、キャプチャされたテキストと終了状態を返します。

RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)

指定したファイル名と省略可能な引数を使用してプロセスを非同期的に開始し、標準の出力とエラーをキャプチャし、終了するまで待機して、キャプチャされたテキストと終了の状態を返します。

RunAndCaptureTextAsync(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.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)

パラメーター

startInfo
ProcessStartInfo

プロセスの開始に使用される情報を含む ProcessStartInfo 。

cancellationToken
CancellationToken

非同期操作を取り消すトークン。 トークンが取り消されると、プロセスは強制終了されます。

返品

非同期操作を表すタスク。 タスクの値には、キャプチャされたテキスト出力とプロセスの終了状態が含まれます。

属性

例外

startInfo は nullです。

UseShellExecute は true に設定されます。

または

RedirectStandardOutput または RedirectStandardError が trueに設定されていません。

リダイレクトされたストリームの読み取り中に cancellationToken が取り消されました。

注釈

リダイレクトされたストリームの読み取り中にキャンセルが発生した場合、メソッドはプロセスの強制終了を試み、 OperationCanceledExceptionをスローします。 ストリームが完全に読み取られた後、プロセスの終了を待機している間に取り消しが発生した場合、プロセスは強制終了され、返されたExitStatusCanceledtrueに設定されます。

適用対象

RunAndCaptureTextAsync(String, IEnumerable<String>, 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.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)

パラメーター

fileName
String

開始する実行可能ファイルの名前。

arguments
IEnumerable<String>

プロセスに渡すコマンド ライン引数。 nullまたは空のシーケンスを渡して、追加の引数なしでプロセスを開始します。

cancellationToken
CancellationToken

非同期操作を取り消すトークン。 トークンが取り消されると、プロセスは強制終了されます。

返品

非同期操作を表すタスク。 タスクの値には、キャプチャされたテキスト出力とプロセスの終了状態が含まれます。

属性

例外

fileName は nullです。

fileName が空です。

リダイレクトされたストリームの読み取り中に cancellationToken が取り消されました。

注釈

リダイレクトされたストリームの読み取り中にキャンセルが発生した場合、メソッドはプロセスの強制終了を試み、 OperationCanceledExceptionをスローします。 ストリームが完全に読み取られた後、プロセスの終了を待機している間に取り消しが発生した場合、プロセスは強制終了され、返されたExitStatusCanceledtrueに設定されます。

適用対象