Process.RunAndCaptureText 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 |
|---|---|
| RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>) |
Startet 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. |
| RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>) |
Startet den beschriebenen |
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)
- Quelle:
- Process.Scenarios.cs
Startet 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.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.ProcessTextOutputPublic Shared Function RunAndCaptureText (fileName As String, Optional arguments As IEnumerable(Of String) = Nothing, Optional timeout As Nullable(Of TimeSpan) = Nothing) As ProcessTextOutputParameter
- 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.
Die maximale Zeitdauer, bis der Vorgang beendet wird. Wenn null, wartet auf unbestimmte Zeit. Wenn der Prozess nicht innerhalb des angegebenen Timeouts beendet wird, wird er getötet.
Gibt zurück
Der erfasste Textausgabe- und Ausgangsstatus des Prozesses.
- Attribute
Ausnahmen
timeout, abgeschnitten auf eine ganze Anzahl von Millisekunden, ist kleiner als -1 oder größer als MaxValue.
fileName ist null.
fileName ist leer.
Die umgeleiteten Datenströme wurden nicht vollständig innerhalb des angegebenen timeoutgelesen.
Hinweise
Wenn das Timeout beim Lesen der umgeleiteten Datenströme abläuft, versucht die Methode, den Prozess zu beenden und auslöst TimeoutException. Wenn die Datenströme vollständig gelesen wurden, der Prozess aber nicht innerhalb des verbleibenden Timeouts beendet wird, wird der Prozess beendet, und der zurückgegebene ExitStatus Vorgang wurde Canceled auf " true.
Gilt für:
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)
- Quelle:
- Process.Scenarios.cs
Startet den beschriebenen startInfoProzess, 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.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.ProcessTextOutputPublic Shared Function RunAndCaptureText (startInfo As ProcessStartInfo, Optional timeout As Nullable(Of TimeSpan) = Nothing) As ProcessTextOutputParameter
- startInfo
- ProcessStartInfo
Die ProcessStartInfo informationen, die zum Starten des Prozesses verwendet werden.
Die maximale Zeitdauer, bis der Vorgang beendet wird. Wenn null, wartet auf unbestimmte Zeit. Wenn der Prozess nicht innerhalb des angegebenen Timeouts beendet wird, wird er getötet.
Gibt zurück
Der erfasste Textausgabe- und Ausgangsstatus des Prozesses.
- Attribute
Ausnahmen
timeout, abgeschnitten auf eine ganze Anzahl von Millisekunden, ist kleiner als -1 oder größer als MaxValue.
startInfo ist null.
UseShellExecute ist auf true festgelegt.
– oder –
RedirectStandardOutput oder RedirectStandardError ist nicht auf true.
Die umgeleiteten Datenströme wurden nicht vollständig innerhalb des angegebenen timeoutgelesen.
Hinweise
Wenn das Timeout beim Lesen der umgeleiteten Datenströme abläuft, versucht die Methode, den Prozess zu beenden und auslöst TimeoutException. Wenn die Datenströme vollständig gelesen wurden, der Prozess aber nicht innerhalb des verbleibenden Timeouts beendet wird, wird der Prozess beendet, und der zurückgegebene ExitStatus Vorgang wurde Canceled auf " true.
