Process.RunAndCaptureText 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
RunAndCaptureText(String, IEnumerable<String>, Nullable<TimeSpan>)	Belirtilen dosya adı ve isteğe bağlı bağımsız değişkenlerle 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.
RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)	tarafından startInfoaçıklanan işlemi başlatır, standart çıkışını ve hatasını yakalar, çıkışını bekler ve yakalanan metin ile çıkış durumunu döndürür.

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

Kaynak:

Process.Scenarios.cs

Belirtilen dosya adı ve isteğe bağlı bağımsız değişkenlerle 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.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

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 .

timeout

Nullable<TimeSpan>

İşlemin çıkması için beklenme süresi üst sınırı. olduğunda nullsüresiz olarak bekler. İşlem belirtilen zaman aşımı içinde çıkılmazsa sonlandırılır.

Döndürülenler

ProcessTextOutput

Yakalanan metin çıkışı ve işlemin çıkış durumu.

Öznitelikler

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Özel durumlar

ArgumentOutOfRangeException

timeout, milisaniye cinsinden tamsayıya yuvarlanır, -1'den küçük veya değerinden MaxValuebüyüktür.

ArgumentNullException

fileName, null'e eşittir.

ArgumentException

fileName boş.

TimeoutException

Yeniden yönlendirilen akışlar belirtilen timeoutiçinde tam olarak okunamadı.

Açıklamalar

Yeniden yönlendirilen akışları okurken zaman aşımı süresi dolarsa, yöntemi işlemi sonlandırmaya çalışır ve oluşturur TimeoutException. Akışlar tamamen okunduysa ancak işlem kalan zaman aşımı içinde çıkılmıyorsa, işlem sonlandırılır ve döndürülen ExitStatusCanceled değeri olarak trueayarlanır.

RunAndCaptureText(ProcessStartInfo, Nullable<TimeSpan>)

Kaynak:

Process.Scenarios.cs

tarafından startInfoaçıklanan işlemi 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.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

Parametreler

startInfo

ProcessStartInfo

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

timeout

Nullable<TimeSpan>

İşlemin çıkması için beklenme süresi üst sınırı. olduğunda nullsüresiz olarak bekler. İşlem belirtilen zaman aşımı içinde çıkılmazsa sonlandırılır.

Döndürülenler

ProcessTextOutput

Yakalanan metin çıkışı ve işlemin çıkış durumu.

Öznitelikler

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Özel durumlar

ArgumentOutOfRangeException

timeout, milisaniye cinsinden tamsayıya yuvarlanır, -1'den küçük veya değerinden MaxValuebüyüktür.

ArgumentNullException

startInfo, null'e eşittir.

InvalidOperationException

UseShellExecute olarak ayarlanır true.

-veya-

RedirectStandardOutput veya RedirectStandardError olarak trueayarlanmadı.

TimeoutException

Yeniden yönlendirilen akışlar belirtilen timeoutiçinde tam olarak okunamadı.

Açıklamalar

Yeniden yönlendirilen akışları okurken zaman aşımı süresi dolarsa, yöntemi işlemi sonlandırmaya çalışır ve oluşturur TimeoutException. Akışlar tamamen okunduysa ancak işlem kalan zaman aşımı içinde çıkılmıyorsa, işlem sonlandırılır ve döndürülen ExitStatusCanceled değeri olarak trueayarlanır.