Process.RunAndCaptureTextAsync Metoda

Definicja

Przestrzeń nazw:: System.Diagnostics

Zestawy:: netstandard.dll, System.Diagnostics.Process.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

Nazwisko	Opis
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)	Asynchronicznie uruchamia proces opisany przez `startInfo`program , przechwytuje standardowe dane wyjściowe i błędy, czeka na zakończenie i zwraca przechwycony tekst i stan zakończenia.
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)	Asynchronicznie rozpoczyna proces z określoną nazwą pliku i opcjonalnymi argumentami, przechwytuje standardowe dane wyjściowe i błędy, czeka na zakończenie i zwraca przechwycony tekst i stan zakończenia.

RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)

Źródło:: Process.Scenarios.cs

Asynchronicznie uruchamia proces opisany przez startInfoprogram , przechwytuje standardowe dane wyjściowe i błędy, czeka na zakończenie i zwraca przechwycony tekst i stan zakończenia.

[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)

Parametry

startInfo: ProcessStartInfo

Element ProcessStartInfo zawierający informacje używane do rozpoczęcia procesu.

cancellationToken: CancellationToken

Token umożliwiający anulowanie operacji asynchronicznej. Jeśli token zostanie anulowany, proces zostanie zabity.

Zwraca

Task<ProcessTextOutput>

Zadanie reprezentujące operację asynchroniczną. Wartość zadania zawiera przechwycone dane wyjściowe tekstu i stan zakończenia procesu.

Atrybuty: SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

Parametr startInfo ma wartość null.

InvalidOperationException

UseShellExecute jest ustawiony na true.

— lub —

RedirectStandardOutput lub RedirectStandardError nie jest ustawiona na truewartość .

OperationCanceledException

Element cancellationToken został anulowany podczas odczytywania przekierowanych strumieni.

Uwagi

Jeśli podczas odczytywania przekierowanych strumieni nastąpi anulowanie, metoda próbuje zabić proces i zgłasza błąd OperationCanceledException. Jeśli anulowanie nastąpi po pełnym odczytaniu strumieni, ale podczas oczekiwania na zakończenie procesu proces zostanie zabity, a zwrócony ExitStatus parametr ma Canceled wartość true.

Dotyczy

RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)

Źródło:: Process.Scenarios.cs

Asynchronicznie rozpoczyna proces z określoną nazwą pliku i opcjonalnymi argumentami, przechwytuje standardowe dane wyjściowe i błędy, czeka na zakończenie i zwraca przechwycony tekst i stan zakończenia.

[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)

Parametry

fileName: String

Nazwa pliku wykonywalnego do uruchomienia.

arguments: IEnumerable<String>

Argumenty wiersza polecenia, które mają być przekazywane do procesu. Przekaż null lub pustą sekwencję, aby rozpocząć proces bez dodatkowych argumentów.

cancellationToken: CancellationToken

Token umożliwiający anulowanie operacji asynchronicznej. Jeśli token zostanie anulowany, proces zostanie zabity.

Zwraca

Task<ProcessTextOutput>

Zadanie reprezentujące operację asynchroniczną. Wartość zadania zawiera przechwycone dane wyjściowe tekstu i stan zakończenia procesu.

Atrybuty: SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

Parametr fileName ma wartość null.

ArgumentException

fileName jest pusta.

OperationCanceledException

Element cancellationToken został anulowany podczas odczytywania przekierowanych strumieni.

Uwagi

Dotyczy

Opinia

Czy ta strona była pomocna?