通过Roslyn构建自己的C#脚本

通过Roslyn构建自己的C#脚本

在下一代的C#中，一个重要的特性就是"Compiler as a Service"，简单的讲，就是就是将编译器开放为一种可在代码中调用的服务。最近使用了一下微软放出的Project Roslyn CTP版，感觉还是非常强大的。

要在自己的代码中执行C#脚本，首先进行如下几步准备工作。

1. 在微软的网站下载Roslyn CTP版并安装
2. 在工程中添加Roslyn.Compilers.dll和Roslyn.Compilers.CSharp.dll的引用
3. 在代码中增加如下命名空间的引用。
   using Roslyn.Scripting;
   using Roslyn.Scripting.CSharp;

经典的HelloWorld

首先还是以经典的Hello World来开始介绍如何执行脚本吧。

    static void Main(string[] args)
    {
        var scriptEngine = new ScriptEngine();
        scriptEngine.Execute("System.Console.WriteLine("hello world")");
    }

从上述代码中可以看出，执行一个脚本还是比较简单的，只要创建一个ScriptEngine对象，然后就可以通过ScriptEngine.Execute()函数执行自己的脚本了。

如果我们要获取脚本的返回值，也是很容易的。

    var result = scriptEngine.Execute<int>("3+2*5");
    Console.WriteLine(result);

在会话中执行脚本

很多时候，我们无法一次执行所有的脚本，而是像shell中那样输入一句执行一句的。假如我们执行如下代码：

    var scriptEngine = new ScriptEngine();
    scriptEngine.Execute("var i = 3;");
    var result = scriptEngine.Execute("i * 2");

得到的并不是我们想要的结果6，而是一个异常：(1,1): error CS0103: The name 'i' does not exist in the current context。

究其原因，是因为ScriptEngine.Execute()函数每次都是在一个单独的上下文中执行的，并不会和前面的语句产生关联。如果我们要在ScriptEngine.Execute()函数中添加Session参数，以标明其是在同一个会话中的。正确方式如下：

    var scriptEngine = new ScriptEngine();
    var session = Session.Create();
    scriptEngine.Execute("var i = 3;", session);
    var result = scriptEngine.Execute("i * 2", session);

在脚本和程序中共享数据

我们在执行脚本时，除了获取脚本的输出外，许多时候需要设置脚本的输入，要设置输入的方式也有许多。最直接的方式拼接脚本但这么做的效率和可维护性是十分差的。另外也可以通过传统的IPC通信机制——文件、Socket等方式，这种方式一来比较麻烦，二来对于复杂的对象来说，还牵涉到序列化，也是非常不便。

Roslyn提供了一个更为简单有效的解决办法：在会话中传入一个宿主对象，会话中的脚本程序也能访问宿主对象的各成员变量。

还是举一个简单的例子吧：

    namespace Host
    {
        public class HostObject
        {
            public string State = "Hello";
        }
    }

    class Program
    {
        static void Main(string[] args)
        {
            var hostReference = new Roslyn.Compilers.AssemblyFileReference(typeof(Host.HostObject).Assembly.Location);
            var engine = new ScriptEngine(references: new[] { hostReference }, importedNamespaces: new[] { "System" });
            var host = new Host.HostObject();
            var session = Session.Create(host);

            var result = engine.Execute<string>("State + State", session);
            Console.WriteLine(result);

            host.State = "Go Go hello ";
            result = engine.Execute<string>("State + State", session);
            Console.WriteLine(result);
        }
    }

这里首先创建了一个HostObject类型的宿主对象host，再由它创建会话。这样就将host对象的成员变量State嵌入了脚本中，在脚本和程序中都能共享State变量了。