AsyncProcess.Sharp 1.0.1905181338

AsyncProcess

关于

此库是 System.Diagnostics.Process 的一个非常简单的包装器，允许进行异步/等待操作。您不是创建并启动一个 Process，而是创建一个 AsyncProcess 并等待该进程的运行。

目前库不支持所有与 System.Diagnostics.Process 有关的操作，但允许以下操作：

• 运行一个进程并异步等待进程结束。
• 捕获标准输出流。
• 捕获标准错误流。
• 设置 CreateNoWindow 属性。
• 设置启动参数
• 设置当前工作目录。
• 取消异步进程。

AsyncProcess 的所有运行方法都返回一个 AsyncProcessResult。此结果包含结果的状 态（即进程是否完成或是否发生错误）。如果进程成功完成，则结果将包含进程的退出代码。如果进程失败，则 Exception 属性将设置为实现进程时发生的异常。

在构造AsyncProcess对象时，您可以传递一个可选 cancellation token，异步过程将尊重该 token。但是，这个过程可能不会立即退出。当设置 cancellation token 时，将会对内部 System.Diagnostics.Process 执行 Kill 方法，我们将等待直到过程 HasExited 属性返回 true。

示例

运行过程并使用过程的退出代码

using (var process = new AsyncProcess(new AsyncProcessStartInfo("ping.exe", "www.github.com")))
{
    var result = await process.Run();
    Console.WriteLine($"The pinging of github resulted in the exit code: {result.ExitCode}");
}

运行过程并处理错误

using (var process = new AsyncProcess(new AsyncProcessStartInfo("missing-file.exe")))
{
    var result = await process.Run();
    if (result.Exception != null)
    {
    	throw new Exception($"Failed to run 'missing-file.exe', result: ${result.CompletionState}",
							result.Exception);
    }
}

使用回调捕获过程的输出

var startInfo = new AsyncProcessStartInfo("ping.exe", "www.github.com")
{
    OnStandardOutputReceived = message =>
    {
        Console.WriteLine($"Info: {message}");
    },
    OnStandardErrorReceived = message =>
    {
        Console.WriteLine($"Error: {message}");
    }
};

using (var process = new AsyncProcess(startInfo))
{
    var result = await process.Run();
    Console.WriteLine($"The pinging of github resulted in the exit code: {result.ExitCode}");
}

将过程的输出捕获并存储在结果中

var startInfo = new AsyncProcessStartInfo("ping.exe", "www.github.com")
{
    CaptureOutputToProcessResult = ProcessOutputCaptureMode.Both
};

using (var process = new AsyncProcess(startInfo))
{
    var result = await process.Run();
    Console.WriteLine($"The pinging of github resulted in the exit code: {result.ExitCode}");
	Console.WriteLine($"Standard Output: {result.StandardOutput}");	
	Console.WriteLine($"Standard Error: {result.StandardError}");	
}

辅助方法

有一些辅助方法，允许单行使用 AsyncProcess 类

await AsyncProcess.Run("notepad.exe")

/// <summary>
/// Create a new process, executing the specified file.
/// </summary>
/// <param name="fileName">The file to use when launching the process.</param>
/// <returns>An awaitable task containing the result of the process run.</returns>
public static async Task<AsyncProcessResult> Run(string fileName)

await AsyncProcess.Run("notepad.exe", @"C:\Windows\System32\drivers\etc\hosts")

/// <summary>
/// Create a new process, executing the specified file with the provided launch arguments.
/// </summary>
/// <param name="fileName">The file to use when launching the process.</param>
/// <param name="arguments">The arguments to use when launching the process.</param>
/// <returns>An awaitable task containing the result of the process run.</returns>
public static async Task<AsyncProcessResult> Run(string fileName, string arguments)

await AsyncProcess.Run(new AsyncProcessStartInfo("notepad.exe"))

/// <summary>
/// Create a new process, executing using the provided start info.
/// </summary>
/// <param name="startInfo">The information used when starting the new process.</param>
/// <returns>An awaitable task containing the result of the process run.</returns>
public static async Task<AsyncProcessResult> Run(AsyncProcessStartInfo startInfo)