Process.RunAndCaptureTextAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken) |
Startet den beschriebenen |
| RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken) |
Startet asynchron einen Prozess mit dem angegebenen Dateinamen und optionalen Argumenten, erfasst die Standardausgabe und den Fehler, wartet darauf, dass er beendet wird, und gibt den erfassten Text und den Beendigungsstatus zurück. |
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)
- Quelle:
- Process.Scenarios.cs
Startet den beschriebenen startInfoProzess asynchron, erfasst seine Standardausgabe und den Standardfehler, wartet darauf, dass er beendet wird, und gibt den erfassten Text und den Ausgangsstatus zurück.
[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)Parameter
- startInfo
- ProcessStartInfo
Die ProcessStartInfo informationen, die zum Starten des Prozesses verwendet werden.
- cancellationToken
- CancellationToken
Ein Token zum Abbrechen des asynchronen Vorgangs. Wenn das Token abgebrochen wird, wird der Prozess getötet.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt. Der Wert der Aufgabe enthält die erfasste Textausgabe und den Ausgangsstatus des Prozesses.
- Attribute
Ausnahmen
startInfo ist null.
UseShellExecute ist auf true festgelegt.
– oder –
RedirectStandardOutput oder RedirectStandardError ist nicht auf true.
Der cancellationToken Vorgang wurde beim Lesen der umgeleiteten Datenströme abgebrochen.
Hinweise
Wenn der Abbruch beim Lesen der umgeleiteten Datenströme auftritt, versucht die Methode, den Prozess zu beenden und löst .OperationCanceledException Wenn der Abbruch auftritt, nachdem die Datenströme vollständig gelesen wurden, während sie auf das Beenden des Prozesses warten, wird der Prozess beendet und der zurückgegebene ExitStatusCanceled Wert auf " true.
Gilt für:
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)
- Quelle:
- Process.Scenarios.cs
Startet asynchron einen Prozess mit dem angegebenen Dateinamen und optionalen Argumenten, erfasst die Standardausgabe und den Fehler, wartet darauf, dass er beendet wird, und gibt den erfassten Text und den Beendigungsstatus zurück.
[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)Parameter
- fileName
- String
Der Name der ausführbaren Datei, die gestartet werden soll.
- arguments
- IEnumerable<String>
Die Befehlszeilenargumente, die an den Prozess übergeben werden sollen. Übergeben null Oder eine leere Sequenz, um den Prozess ohne zusätzliche Argumente zu starten.
- cancellationToken
- CancellationToken
Ein Token zum Abbrechen des asynchronen Vorgangs. Wenn das Token abgebrochen wird, wird der Prozess getötet.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt. Der Wert der Aufgabe enthält die erfasste Textausgabe und den Ausgangsstatus des Prozesses.
- Attribute
Ausnahmen
fileName ist null.
fileName ist leer.
Der cancellationToken Vorgang wurde beim Lesen der umgeleiteten Datenströme abgebrochen.
Hinweise
Wenn der Abbruch beim Lesen der umgeleiteten Datenströme auftritt, versucht die Methode, den Prozess zu beenden und löst .OperationCanceledException Wenn der Abbruch auftritt, nachdem die Datenströme vollständig gelesen wurden, während sie auf das Beenden des Prozesses warten, wird der Prozess beendet und der zurückgegebene ExitStatusCanceled Wert auf " true.
