Process.RunAndCaptureText Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestawy:

netstandard.dll, System.Diagnostics.Process.dll

Przeciążenia

Nazwisko	Opis
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)	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.
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)	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.

RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)

Źródło:

Process.Scenarios.cs

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.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

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.

timeout

Nullable<TimeSpan>

Maksymalny czas oczekiwania na zakończenie procesu. Gdy nullprogram czeka na czas nieokreślony. Jeśli proces nie zostanie zamknięty w określonym przedziale czasu, zostanie on zabity.

Zwraca

ProcessTextOutput

Przechwycone dane wyjściowe tekstu i stan zakończenia procesu.

Atrybuty

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Wyjątki

ArgumentOutOfRangeException

timeout, obcięty do liczby całkowitej milisekund, jest mniejszy niż -1 lub większy niż MaxValue.

ArgumentNullException

Parametr fileName ma wartość null.

ArgumentException

fileName jest pusta.

TimeoutException

Przekierowane strumienie nie były w pełni odczytywane w ramach określonego timeoutelementu .

Uwagi

Jeśli limit czasu wygaśnie podczas odczytywania przekierowanych strumieni, metoda próbuje zabić proces i zgłasza błąd TimeoutException. Jeśli strumienie zostały w pełni odczytane, ale proces nie kończy się w ciągu pozostałego limitu czasu, proces zostanie zabity, a zwrócony ExitStatus parametr ma Canceled wartość true.

RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)

Źródło:

Process.Scenarios.cs

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.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

Parametry

startInfo

ProcessStartInfo

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

timeout

Nullable<TimeSpan>

Maksymalny czas oczekiwania na zakończenie procesu. Gdy nullprogram czeka na czas nieokreślony. Jeśli proces nie zostanie zamknięty w określonym przedziale czasu, zostanie on zabity.

Zwraca

ProcessTextOutput

Przechwycone dane wyjściowe tekstu i stan zakończenia procesu.

Atrybuty

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Wyjątki

ArgumentOutOfRangeException

timeout, obcięty do liczby całkowitej milisekund, jest mniejszy niż -1 lub większy niż MaxValue.

ArgumentNullException

Parametr startInfo ma wartość null.

InvalidOperationException

UseShellExecute jest ustawiony na true.

— lub —

RedirectStandardOutput lub RedirectStandardError nie jest ustawiona na truewartość .

TimeoutException

Przekierowane strumienie nie były w pełni odczytywane w ramach określonego timeoutelementu .

Uwagi

Jeśli limit czasu wygaśnie podczas odczytywania przekierowanych strumieni, metoda próbuje zabić proces i zgłasza błąd TimeoutException. Jeśli strumienie zostały w pełni odczytane, ale proces nie kończy się w ciągu pozostałego limitu czasu, proces zostanie zabity, a zwrócony ExitStatus parametr ma Canceled wartość true.