Process.RunAndCaptureTextAsync Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Diagnostics.Process.dll

Aşırı Yüklemeler

Veri Akışı Adı	Description
RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)	tarafından startInfotanımlanan işlemi zaman uyumsuz olarak başlatır, standart çıkışını ve hatasını yakalar, çıkışını bekler ve yakalanan metin ile çıkış durumunu döndürür.
RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)	Belirtilen dosya adı ve isteğe bağlı bağımsız değişkenlerle zaman uyumsuz olarak bir işlem başlatır, standart çıkışını ve hatasını yakalar, çıkışını bekler ve yakalanan metin ile çıkış durumunu döndürür.

RunAndCaptureTextAsync(ProcessStartInfo, CancellationToken)

Kaynak:

Process.Scenarios.cs

tarafından startInfotanımlanan işlemi zaman uyumsuz olarak başlatır, standart çıkışını ve hatasını yakalar, çıkışını bekler ve yakalanan metin ile çıkış durumunu döndürür.

[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)

Parametreler

startInfo

ProcessStartInfo

İşlemi ProcessStartInfo başlatmak için kullanılan bilgileri içeren.

cancellationToken

CancellationToken

Zaman uyumsuz işlemi iptal etmek için bir belirteç. Belirteç iptal edilirse işlem sonlandırılır.

Döndürülenler

Task<ProcessTextOutput>

Zaman uyumsuz işlemi temsil eden bir görev. Görevin değeri, işlemin yakalanan metin çıkışını ve çıkış durumunu içerir.

Öznitelikler

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

startInfo, null'e eşittir.

InvalidOperationException

UseShellExecute olarak ayarlanır true.

-veya-

RedirectStandardOutput veya RedirectStandardError olarak trueayarlanmadı.

OperationCanceledException

yeniden cancellationToken yönlendirilen akışlar okunurken iptal edildi.

Açıklamalar

Yeniden yönlendirilen akışlar okunurken iptal gerçekleşirse, yöntemi işlemi sonlandırmaya çalışır ve oluşturur OperationCanceledException. İptal işlemi akışlar tamamen okunduktan sonra ancak işlemin çıkışını beklerken gerçekleşirse, işlem sonlandırılır ve döndürülen ExitStatusCanceled değeri olarak trueayarlanır.

RunAndCaptureTextAsync(String, IEnumerable<String>, CancellationToken)

Kaynak:

Process.Scenarios.cs

Belirtilen dosya adı ve isteğe bağlı bağımsız değişkenlerle zaman uyumsuz olarak bir işlem başlatır, standart çıkışını ve hatasını yakalar, çıkışını bekler ve yakalanan metin ile çıkış durumunu döndürür.

[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)

Parametreler

fileName

String

Başlatacak yürütülebilir dosyanın adı.

arguments

IEnumerable<String>

İşleme geçirilebilir komut satırı bağımsız değişkenleri. İşlemi ek bağımsız değişkenler olmadan başlatmak için veya boş bir dizi geçirin null .

cancellationToken

CancellationToken

Zaman uyumsuz işlemi iptal etmek için bir belirteç. Belirteç iptal edilirse işlem sonlandırılır.

Döndürülenler

Task<ProcessTextOutput>

Zaman uyumsuz işlemi temsil eden bir görev. Görevin değeri, işlemin yakalanan metin çıkışını ve çıkış durumunu içerir.

Öznitelikler

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

fileName, null'e eşittir.

ArgumentException

fileName boş.

OperationCanceledException

yeniden cancellationToken yönlendirilen akışlar okunurken iptal edildi.

Açıklamalar

Yeniden yönlendirilen akışlar okunurken iptal gerçekleşirse, yöntemi işlemi sonlandırmaya çalışır ve oluşturur OperationCanceledException. İptal işlemi akışlar tamamen okunduktan sonra ancak işlemin çıkışını beklerken gerçekleşirse, işlem sonlandırılır ve döndürülen ExitStatusCanceled değeri olarak trueayarlanır.