Process.RunAndCaptureText 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 |
|---|---|
| RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>) |
Avvia un processo con il nome file e gli argomenti facoltativi specificati, acquisisce l'output e l'errore standard, attende che venga chiuso e restituisce il testo acquisito e lo stato di uscita. |
| RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>) |
Avvia il processo descritto da |
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)
- Origine:
- Process.Scenarios.cs
Avvia un processo con il nome file e gli argomenti facoltativi specificati, acquisisce l'output e l'errore standard, attende che venga chiuso 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.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 ProcessTextOutputParametri
- 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.
Quantità massima di tempo di attesa per l'uscita del processo. Quando null, attende per un periodo illimitato. Se il processo non viene chiuso entro il timeout specificato, viene terminato.
Valori restituiti
Output di testo acquisito e stato di uscita del processo.
- Attributi
Eccezioni
timeout, troncato a un numero intero di millisecondi, è minore di -1 o maggiore di MaxValue.
fileName è null.
fileName è vuoto.
I flussi reindirizzati non sono stati letti completamente all'interno dell'oggetto specificato timeout.
Commenti
Se il timeout scade durante la lettura dei flussi reindirizzati, il metodo tenta di terminare il processo e genera TimeoutException. Se i flussi sono stati letti completamente, ma il processo non viene chiuso entro il timeout rimanente, il processo viene terminato e l'oggetto restituito ExitStatus è Canceled impostato su true.
Si applica a
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)
- Origine:
- Process.Scenarios.cs
Avvia il processo descritto da startInfo, acquisisce l'output e l'errore standard, attende che venga chiusa 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.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 ProcessTextOutputParametri
- startInfo
- ProcessStartInfo
Oggetto ProcessStartInfo contenente le informazioni utilizzate per avviare il processo.
Quantità massima di tempo di attesa per l'uscita del processo. Quando null, attende per un periodo illimitato. Se il processo non viene chiuso entro il timeout specificato, viene terminato.
Valori restituiti
Output di testo acquisito e stato di uscita del processo.
- Attributi
Eccezioni
timeout, troncato a un numero intero di millisecondi, è minore di -1 o maggiore di MaxValue.
startInfo è null.
UseShellExecute è impostato su true.
oppure
RedirectStandardOutput o RedirectStandardError non è impostato su true.
I flussi reindirizzati non sono stati letti completamente all'interno dell'oggetto specificato timeout.
Commenti
Se il timeout scade durante la lettura dei flussi reindirizzati, il metodo tenta di terminare il processo e genera TimeoutException. Se i flussi sono stati letti completamente, ma il processo non viene chiuso entro il timeout rimanente, il processo viene terminato e l'oggetto restituito ExitStatus è Canceled impostato su true.
