Process.RunAndCaptureText Methode

Definitie

Naamruimte:

System.Diagnostics

Assembly's:

netstandard.dll, System.Diagnostics.Process.dll

Overloads

Naam	Description
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)	Start een proces met de opgegeven bestandsnaam en optionele argumenten, legt de standaarduitvoer en fout vast, wacht tot deze is afgesloten en retourneert de vastgelegde tekst- en afsluitstatus.
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)	Start het proces dat wordt beschreven door startInfo, legt de standaarduitvoer en -fout vast, wacht tot het proces is afgesloten en retourneert de vastgelegde tekst en de afsluitstatus.

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

Bron:

Process.Scenarios.cs

Start een proces met de opgegeven bestandsnaam en optionele argumenten, legt de standaarduitvoer en fout vast, wacht tot deze is afgesloten en retourneert de vastgelegde tekst- en afsluitstatus.

[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

Parameters

fileName

String

De naam van het uitvoerbare bestand dat moet worden gestart.

arguments

IEnumerable<String>

De opdrachtregelargumenten die moeten worden doorgegeven aan het proces. Geef null of een lege reeks door om het proces te starten zonder extra argumenten.

timeout

Nullable<TimeSpan>

De maximale hoeveelheid tijd die moet worden gewacht totdat het proces is afgesloten. Wanneer null, wacht voor onbepaalde tijd. Als het proces niet binnen de opgegeven time-out wordt afgesloten, wordt het beëindigd.

Retouren

ProcessTextOutput

De vastgelegde tekstuitvoer en afsluitstatus van het proces.

Kenmerken

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Uitzonderingen

ArgumentOutOfRangeException

timeout, afgekapt tot een geheel aantal milliseconden, kleiner is dan -1 of groter dan MaxValue.

ArgumentNullException

fileName is null.

ArgumentException

fileName is leeg.

TimeoutException

De omgeleide streams zijn niet volledig gelezen binnen de opgegeven timeout.

Opmerkingen

Als de time-out verloopt tijdens het lezen van de omgeleide streams, probeert de methode het proces te beëindigen en genereert TimeoutException. Als de streams volledig zijn gelezen, maar het proces niet binnen de resterende time-out wordt afgesloten, wordt het proces beëindigd en is het geretourneerde ExitStatus proces ingesteld op true.Canceled

RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)

Bron:

Process.Scenarios.cs

Start het proces dat wordt beschreven door startInfo, legt de standaarduitvoer en -fout vast, wacht tot het proces is afgesloten en retourneert de vastgelegde tekst en de afsluitstatus.

[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

Parameters

startInfo

ProcessStartInfo

De ProcessStartInfo informatie die wordt gebruikt om het proces te starten.

timeout

Nullable<TimeSpan>

De maximale hoeveelheid tijd die moet worden gewacht totdat het proces is afgesloten. Wanneer null, wacht voor onbepaalde tijd. Als het proces niet binnen de opgegeven time-out wordt afgesloten, wordt het beëindigd.

Retouren

ProcessTextOutput

De vastgelegde tekstuitvoer en afsluitstatus van het proces.

Kenmerken

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Uitzonderingen

ArgumentOutOfRangeException

timeout, afgekapt tot een geheel aantal milliseconden, kleiner is dan -1 of groter dan MaxValue.

ArgumentNullException

startInfo is null.

InvalidOperationException

UseShellExecute is ingesteld op true.

– of –

RedirectStandardOutput of RedirectStandardError is niet ingesteld op true.

TimeoutException

De omgeleide streams zijn niet volledig gelezen binnen de opgegeven timeout.

Opmerkingen

Als de time-out verloopt tijdens het lezen van de omgeleide streams, probeert de methode het proces te beëindigen en genereert TimeoutException. Als de streams volledig zijn gelezen, maar het proces niet binnen de resterende time-out wordt afgesloten, wordt het proces beëindigd en is het geretourneerde ExitStatus proces ingesteld op true.Canceled