Process.RunAndCaptureText Méthode

Définition

Espace de noms:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.Process.dll

Surcharges

Nom	Description
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)	Démarre un processus avec le nom de fichier et les arguments facultatifs spécifiés, capture sa sortie et son erreur standard, attend qu’elle quitte et retourne le texte capturé et l’état de sortie.
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)	Démarre le processus décrit par startInfo, capture sa sortie et son erreur standard, attend qu’elle quitte et retourne le texte capturé et l’état de sortie.

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

Source:

Process.Scenarios.cs

Démarre un processus avec le nom de fichier et les arguments facultatifs spécifiés, capture sa sortie et son erreur standard, attend qu’elle quitte et retourne le texte capturé et l’état de sortie.

[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

Paramètres

fileName

String

Nom de l’exécutable à démarrer.

arguments

IEnumerable<String>

Arguments de ligne de commande à passer au processus. null Passez ou une séquence vide pour démarrer le processus sans arguments supplémentaires.

timeout

Nullable<TimeSpan>

Durée maximale d’attente de la sortie du processus. Quand null, attend indéfiniment. Si le processus ne se termine pas dans le délai d’expiration spécifié, il est tué.

Retours

ProcessTextOutput

La sortie de texte capturée et l’état de sortie du processus.

Attributs

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceptions

ArgumentOutOfRangeException

timeout, tronqué en un nombre entier de millisecondes, est inférieur à -1 ou supérieur à MaxValue.

ArgumentNullException

fileName a la valeur null.

ArgumentException

fileName est vide.

TimeoutException

Les flux redirigés n’ont pas été entièrement lus dans le fichier spécifié timeout.

Remarques

Si le délai d’expiration expire lors de la lecture des flux redirigés, la méthode tente de tuer le processus et lève TimeoutException. Si les flux ont été entièrement lus, mais que le processus ne se termine pas dans le délai d’expiration restant, le processus est tué et le retour ExitStatus a Canceled la valeur true.

RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)

Source:

Process.Scenarios.cs

Démarre le processus décrit par startInfo, capture sa sortie et son erreur standard, attend qu’elle quitte et retourne le texte capturé et l’état de sortie.

[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

Paramètres

startInfo

ProcessStartInfo

ProcessStartInfo Qui contient les informations utilisées pour démarrer le processus.

timeout

Nullable<TimeSpan>

Durée maximale d’attente de la sortie du processus. Quand null, attend indéfiniment. Si le processus ne se termine pas dans le délai d’expiration spécifié, il est tué.

Retours

ProcessTextOutput

La sortie de texte capturée et l’état de sortie du processus.

Attributs

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceptions

ArgumentOutOfRangeException

timeout, tronqué en un nombre entier de millisecondes, est inférieur à -1 ou supérieur à MaxValue.

ArgumentNullException

startInfo a la valeur null.

InvalidOperationException

UseShellExecute a la valeur true.

- ou -

RedirectStandardOutput ou RedirectStandardError n’est pas défini sur true.

TimeoutException

Les flux redirigés n’ont pas été entièrement lus dans le fichier spécifié timeout.

Remarques

Si le délai d’expiration expire lors de la lecture des flux redirigés, la méthode tente de tuer le processus et lève TimeoutException. Si les flux ont été entièrement lus, mais que le processus ne se termine pas dans le délai d’expiration restant, le processus est tué et le retour ExitStatus a Canceled la valeur true.