Process.RunAndCaptureTextAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken) |
Avvia in modo asincrono il processo descritto da |
| RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken) |
Avvia in modo asincrono un processo con il nome file e gli argomenti facoltativi specificati, acquisisce l'output e l'errore standard, attende che venga chiusa e restituisca il testo acquisito e lo stato di uscita. |
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)
- Origine:
- Process.Scenarios.cs
Avvia in modo asincrono il processo descritto da startInfo, acquisisce l'output e l'errore standard, attende l'uscita e restituisce il testo acquisito e lo stato di uscita.
[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)Parametri
- startInfo
- ProcessStartInfo
Oggetto ProcessStartInfo contenente le informazioni utilizzate per avviare il processo.
- cancellationToken
- CancellationToken
Token per annullare l'operazione asincrona. Se il token viene annullato, il processo viene terminato.
Valori restituiti
Attività che rappresenta l'operazione asincrona. Il valore dell'attività contiene l'output di testo acquisito e lo stato di uscita del processo.
- Attributi
Eccezioni
startInfo è null.
UseShellExecute è impostato su true.
oppure
RedirectStandardOutput o RedirectStandardError non è impostato su true.
L'oggetto cancellationToken è stato annullato durante la lettura dei flussi reindirizzati.
Commenti
Se l'annullamento si verifica durante la lettura dei flussi reindirizzati, il metodo tenta di terminare il processo e genera OperationCanceledException. Se l'annullamento si verifica dopo la lettura completa dei flussi, ma durante l'attesa dell'uscita del processo, il processo viene terminato e l'oggetto restituito ExitStatus è Canceled impostato su true.
Si applica a
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)
- Origine:
- Process.Scenarios.cs
Avvia in modo asincrono un processo con il nome file e gli argomenti facoltativi specificati, acquisisce l'output e l'errore standard, attende che venga chiusa e restituisca il testo acquisito e lo stato di uscita.
[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)Parametri
- fileName
- String
Nome dell'eseguibile da avviare.
- arguments
- IEnumerable<String>
Argomenti della riga di comando da passare al processo. Passare null o una sequenza vuota per avviare il processo senza argomenti aggiuntivi.
- cancellationToken
- CancellationToken
Token per annullare l'operazione asincrona. Se il token viene annullato, il processo viene terminato.
Valori restituiti
Attività che rappresenta l'operazione asincrona. Il valore dell'attività contiene l'output di testo acquisito e lo stato di uscita del processo.
- Attributi
Eccezioni
fileName è null.
fileName è vuoto.
L'oggetto cancellationToken è stato annullato durante la lettura dei flussi reindirizzati.
Commenti
Se l'annullamento si verifica durante la lettura dei flussi reindirizzati, il metodo tenta di terminare il processo e genera OperationCanceledException. Se l'annullamento si verifica dopo la lettura completa dei flussi, ma durante l'attesa dell'uscita del processo, il processo viene terminato e l'oggetto restituito ExitStatus è Canceled impostato su true.
