通过Roslyn构建自己的C#脚本（更新版）

之前写过文章介绍过如何通过Roslyn构建自己的C#脚本，但那篇文章是参考自Roslyn CTP版的，记得本来想等到Roslyn正式版出来重新更新一下文档的，不过记得后来Roslyn是跳票了的，Scripting API在正式版本中都一度被移除了，这个更新就没有做下去了。

最近看到有人在原文中询问如何使用C# Script API，便查询了一下相关资料，这个功能是在的VS2015 update 1中才正式放出的，其时已经到16年了，使用方法与之前已经大有不同了，便重新写一篇介绍下如何使用C# Script。

C# Interactive窗口

微软在Visual Studio中已经提供了一个C#交互窗口，通过它就可以直接执行C# 脚本语句。

    

这个窗口是非常强大的，支持语法高亮，智能提示，使用起来是非常方便的。简单的一些静态函数测试可以直接在该窗口中进行，还是非常方便的。

 

C#命令行接口

C#交互窗口方式虽然很方便，但我们很多时候是希望脚本程序能脱离VisualStudio单独执行，此时我们可以用到的命令行程序csi.exe。

    

一方面csi程序可以以REPL方式执行输入的命令，另一方面它可以可以执行执行脚本文件。

一个简单的示例程序如下（注：可以在VS中编写CSX文件，VS2017就已经有语法高亮和智能提示支持了）

//hello .csx
using System;
var msg = "Hello";
Console.WriteLine(msg);

执行指令如下： csi hello.csx

这样，我们就可以像脚本语言那样加载我们的C#程序了

另外，关于C# Script语法，基本上和C#差不多，主要多了如下两个：

• #load 用来加载别的脚本文件
• #r 用来加载dll

例如

#load "setup.csx"
#r "nunit.core.dll"
#r "nunit.core.interfaces.dll"

我还没有找到官方的文档（谁知道的话请告知），有一些第三方文档可以参考下：Writing a script

 

C# Scripting API

更进一步的，我们可以把脚本程序动态集成到我们的应用程序中，此时就要用到C# Scripting API了。要使用C# Script API，首先需要.net framework 4.6或.net core 1.0以上环境。

然后安装Nuget程序包：Install-Package Microsoft.CodeAnalysis.CSharp.Scripting

首先来个简单的计算：

object result = await CSharpScript.EvaluateAsync("1 + 2");
int result = await CSharpScript.EvaluateAsync<int>("1 + 2");

异常处理也是可以的：

try
{
    Console.WriteLine(await CSharpScript.EvaluateAsync("2+2"));
}
catch (CompilationErrorException e)
{
    Console.WriteLine(string.Join(Environment.NewLine, e.Diagnostics));
}

 

带上下文状态执行：

var state = await CSharpScript.RunAsync("int x = 1;");
state = await state.ContinueWithAsync("int y = 2;");
state = await state.ContinueWithAsync("x+y");
Console.WriteLine(state.ReturnValue);

添加程序集引用：

var result = await CSharpScript.EvaluateAsync("System.Net.Dns.GetHostName()",
ScriptOptions.Default.WithReferences(typeof(System.Net.Dns).Assembly));

添加using导入

var result = await CSharpScript.EvaluateAsync("Sqrt(2)",
ScriptOptions.Default.WithImports("System.Math"));

和宿主程序中的对象交互：

public class Globals
{
    public int X;
    public int Y;
}

var globals = new Globals { X = 1, Y = 2 };
Console.WriteLine(await CSharpScript.EvaluateAsync<int>("X+Y", globals: globals));

作为脚本重复执行：

var script = CSharpScript.Create<int>("X*Y", globalsType: typeof(Globals));
script.Compile();
for (int i = 0; i < 10; i++)
{
    Console.WriteLine((await script.RunAsync(new Globals { X = i, Y = i })).ReturnValue);
}

脚本也可以携带上下文状态：

var script = CSharpScript.Create<int>("int x = 1;").
    ContinueWith("int y = 2;").
    ContinueWith("x + y");
    Console.WriteLine((await script.RunAsync()).ReturnValue);

当然除了Roslyn外，也有一些第三方的脚本解决方案，使用时也可以参考一下。

• Nake  (.Net Framework & Mono)
• dotnet script  (.NET Core)
• ScriptCS

 

参考文章：

• https://github.com/dotnet/roslyn/wiki/Scripting-API-Samples
• https://msdn.microsoft.com/en-us/magazine/mt614271.aspx
• http://gsferreira.com/archive/2016/02/the-shining-new-csharp-scripting-api/