Process.RunAndCaptureTextAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken) |
Asynkront startar processen som beskrivs av |
| RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken) |
Asynkront startar en process med det angivna filnamnet och valfria argument, samlar in standardutdata och -fel, väntar tills den avslutas och returnerar den insamlade text- och slutstatusen. |
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)
- Källa:
- Process.Scenarios.cs
Asynkront startar processen som beskrivs av startInfo, samlar in standardutdata och -fel, väntar tills den avslutas och returnerar den insamlade text- och slutstatusen.
[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)
Parametrar
- startInfo
- ProcessStartInfo
Som ProcessStartInfo innehåller den information som används för att starta processen.
- cancellationToken
- CancellationToken
En token för att avbryta den asynkrona åtgärden. Om token avbryts avbryts processen.
Returer
En uppgift som representerar den asynkrona åtgärden. Värdet för uppgiften innehåller insamlade textutdata och processens slutstatus.
- Attribut
Undantag
startInfo är null.
UseShellExecute är inställt på true.
-or-
RedirectStandardOutput eller RedirectStandardError är inte inställt på true.
Avbröts cancellationToken när de omdirigerade strömmarna lästes.
Kommentarer
Om annulleringen sker när de omdirigerade strömmarna läss försöker metoden att avsluta processen och genererar OperationCanceledException. Om annulleringen sker efter att strömmarna har lästs helt, men i väntan på att processen ska avslutas, avbryts processen och den returnerade ExitStatus har Canceled angetts till true.
Gäller för
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)
- Källa:
- Process.Scenarios.cs
Asynkront startar en process med det angivna filnamnet och valfria argument, samlar in standardutdata och -fel, väntar tills den avslutas och returnerar den insamlade text- och slutstatusen.
[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)
Parametrar
- fileName
- String
Namnet på den körbara fil som ska startas.
- arguments
- IEnumerable<String>
Kommandoradsargumenten som ska skickas till processen. Skicka null eller en tom sekvens för att starta processen utan ytterligare argument.
- cancellationToken
- CancellationToken
En token för att avbryta den asynkrona åtgärden. Om token avbryts avbryts processen.
Returer
En uppgift som representerar den asynkrona åtgärden. Värdet för uppgiften innehåller insamlade textutdata och processens slutstatus.
- Attribut
Undantag
fileName är null.
fileName är tom.
Avbröts cancellationToken när de omdirigerade strömmarna lästes.
Kommentarer
Om annulleringen sker när de omdirigerade strömmarna läss försöker metoden att avsluta processen och genererar OperationCanceledException. Om annulleringen sker efter att strömmarna har lästs helt, men i väntan på att processen ska avslutas, avbryts processen och den returnerade ExitStatus har Canceled angetts till true.