Process.RunAndCaptureTextAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken) |
Démarre de façon asynchrone le processus décrit par |
| RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken) |
Démarre de façon asynchrone un processus avec le nom de fichier et les arguments facultatifs spécifiés, capture sa sortie et son erreur standard, attend qu’il se termine et retourne le texte capturé et l’état de sortie. |
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)
- Source:
- Process.Scenarios.cs
Démarre de façon asynchrone le processus décrit par startInfo, capture sa sortie et son erreur standard, attend qu’elle se termine 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.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)Paramètres
- startInfo
- ProcessStartInfo
ProcessStartInfo Qui contient les informations utilisées pour démarrer le processus.
- cancellationToken
- CancellationToken
Jeton pour annuler l’opération asynchrone. Si le jeton est annulé, le processus est tué.
Retours
Tâche qui représente l’opération asynchrone. La valeur de la tâche contient la sortie de texte capturée et l’état de sortie du processus.
- Attributs
Exceptions
startInfo a la valeur null.
UseShellExecute a la valeur true.
- ou -
RedirectStandardOutput ou RedirectStandardError n’est pas défini sur true.
L’opération cancellationToken a été annulée lors de la lecture des flux redirigés.
Remarques
Si l’annulation se produit lors de la lecture des flux redirigés, la méthode tente de tuer le processus et lève OperationCanceledException. Si l’annulation se produit après que les flux ont été entièrement lus, mais en attendant que le processus se termine, le processus est tué et le retour ExitStatus a Canceled la valeur true.
S’applique à
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)
- Source:
- Process.Scenarios.cs
Démarre de façon asynchrone un processus avec le nom de fichier et les arguments facultatifs spécifiés, capture sa sortie et son erreur standard, attend qu’il se termine 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.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)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.
- cancellationToken
- CancellationToken
Jeton pour annuler l’opération asynchrone. Si le jeton est annulé, le processus est tué.
Retours
Tâche qui représente l’opération asynchrone. La valeur de la tâche contient la sortie de texte capturée et l’état de sortie du processus.
- Attributs
Exceptions
fileName a la valeur null.
fileName est vide.
L’opération cancellationToken a été annulée lors de la lecture des flux redirigés.
Remarques
Si l’annulation se produit lors de la lecture des flux redirigés, la méthode tente de tuer le processus et lève OperationCanceledException. Si l’annulation se produit après que les flux ont été entièrement lus, mais en attendant que le processus se termine, le processus est tué et le retour ExitStatus a Canceled la valeur true.
