Process.RunAndCaptureTextAsync 方法

定義

命名空間:: System.Diagnostics

組件:: netstandard.dll, System.Diagnostics.Process.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
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

一個取消非同步操作的標記。若標記被取消，程序即終止。

傳回

Task<ProcessTextOutput>

一個代表非同步操作的任務。任務值包含擷取的文字輸出及程序的退出狀態。

屬性: SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

例外狀況

ArgumentNullException

startInfo 是 null。

InvalidOperationException

UseShellExecute 設定為 true。

-或者-

RedirectStandardOutput 或 RedirectStandardError 未設定為 true。

OperationCanceledException

在閱讀重定向串流時，節目 cancellationToken 被取消了。

備註

若在讀取重定向串流時發生消去，該方法會嘗試終止程序並拋 OperationCanceledException出。若在串流完全讀取後且等待程序退出時取消，程序會被終止，回傳 ExitStatus 的程序將 Canceled 設定為 true。

適用於

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)