Process.RunAndCaptureText メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

netstandard.dll, System.Diagnostics.Process.dll

オーバーロード

Name	説明
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をスローします。 ストリームが完全に読み取られたが、残りのタイムアウト時間内にプロセスが終了しない場合、プロセスは強制終了され、返されたExitStatusCanceledtrueに設定されます。

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をスローします。 ストリームが完全に読み取られたが、残りのタイムアウト時間内にプロセスが終了しない場合、プロセスは強制終了され、返されたExitStatusCanceledtrueに設定されます。