Process.RunAndCaptureTextAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken) |
|
| RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken) |
指定したファイル名と省略可能な引数を使用してプロセスを非同期的に開始し、標準の出力とエラーをキャプチャし、終了するまで待機して、キャプチャされたテキストと終了の状態を返します。 |
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)
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)
指定したファイル名と省略可能な引数を使用してプロセスを非同期的に開始し、標準の出力とエラーをキャプチャし、終了するまで待機して、キャプチャされたテキストと終了の状態を返します。
[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に設定されます。