Skip to main content

C# As a Scripting Language in your .NET Applications – Using Mono’s Compiler As a Service

image Note: This is the third article in the series. In the first two articles, I explained


In this post, we’ll see how to use C# as a scripting language in your .NET applications. Let us start with a very minimal game application, where you have two players, and your users can control these players by writing some script.

In the previous post, I explained how to create a delegate/predicate from Mono’s Evaluator and pass it back to the Main application, so that we can use the predicate for custom filtering operations. Now, What is interesting in below code is, how we are passing the context information from the main application to Mono’s Evaluator, so that the objects from the main applications can be accessed via Mono’s Evaluator for scripting.

C# For Scripting

So here we go. Have a look at this entire implementation first. Fire up a console project in Visual Studio, add a reference to Mono.CSharp.dll (See the first post), and try this code. (You can click ‘Copy to clipboard’ for copying the code from the listing below).

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Mono.CSharp;

namespace MonoHost
    // A simple extension class with methods to 
    // invoke Evaluator methods on a string
    public static class EvaluatorExtensions
        public static T Eval<T>(this string code) where T : class
            return Evaluator.Evaluate(code) as T;

        public static void Run(this string code, bool repQuotes = false)
            var run = repQuotes ?
                        code.Replace("'", "\"") : code;

    //A simple player class so that we can create few 
    //player objects later
    public class Player
        public string Name { get; set; }

        public void Attack(Player target)
            Console.WriteLine(Name + " is attacking " + target.Name);

        public void Jump()
           Console.WriteLine(Name + " is jumping");

        public void Goto(int x,int y) 
           Console.WriteLine(Name + " is going to " + x + "," + y);

    // A Context class to share context between our ScriptDriver and Mono's Evaluator 
    public static class Context
        static Context()
            Items = new Dictionary<string, object>();
        public static Dictionary<string, object> Items { get; set; }

    //Main Program
    class ScriptDriver
        static void Main(string[] args)
            //Initializing the evaluator
            Evaluator.Init(new string[0]);

            //Step 1 - Add this assembly as a reference so that we can access the Context class

            //Using evaluator to run some code
            //via our Extension method
            @"using System;
              using System.Linq;
              using MonoHost;
              using System.Collections.Generic;"

            //Step 2 - Adding few items to the Context
            Context.Items.Add("jim", new Player { Name = "Jim" });
            Context.Items.Add("joe", new Player { Name = "Joe" });

            //Step 3 - Retreive the items from the Context in Evaluator
            @"var jim=(Player)Context.Items['jim'];
              var joe=(Player)Context.Items['joe'];"

            Console.WriteLine("<<-- Game Started - Control Jim and Joe. -->>");

            while (true)
                string input = Console.ReadLine();
                if (input.Equals("@@")) return;
                try { input.Run(); }
                catch (Exception ex) { Console.WriteLine(ex.Message); }


There are a couple of simple, but interesting tricks to note in the above code. We have a Context class with a static dictionary inside the same, to pass data back and forth between our main application and the Evaluator.

  • In Step 1, see how are are adding the current assembly as a reference to the Evaluator, so that we can access the Context class.
  • In Step 2, we are filling the context with some instances created in the main application
  • In Step 3, see how we are retrieving the instances in the Evaluator, from the context

Now, as we have our objects exposed to Evaluator, we can use them from the script. Run the application, and have fun with invoking methods of your ‘jim’ and ‘joe’ objects in the script. This is my script console when I run the above program

<<-- Game Started - Control Jim and Joe. Enter @@ to stop -->>
Jim is attacking Joe
->for (int i=0;i<40;i+=5) joe.Goto(20,30+i);
Joe is going to 20,30
Joe is going to 20,35
Joe is going to 20,40
Joe is going to 20,45
Joe is going to 20,50
Joe is going to 20,55
Joe is going to 20,60
Joe is going to 20,65
Joe is jumping
Jim is jumping
Joe is attacking Jim

That is cool, isn’t it? So now you know how to expose your ‘mainstream’ objects to Evaluator, for providing some C# scripting features in your application. Happy Coding!!


Also, don’t miss my earlier post 4 .NET Libraries You *Should* know better

Popular posts from this blog

MVVM - Binding Multiple Radio Buttons To a single Enum Property in WPF

I had a property in my View Model, of an Enum type, and wanted to bind multiple radio buttons to this.

Firstly, I wrote a simple Enum to Bool converter, like this.

public class EnumToBoolConverter : IValueConverter { #region IValueConverter Members public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture) { if (parameter.Equals(value)) return true; else return false; } public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture) { return parameter; } #endregion }

And my enumeration is like

public enum CompanyTypes { Type1Comp, Type2Comp, Type3Comp } Now, in my XAML, I provided the enumeration as the ConverterParameter, of the Converter we wrote earlier, like

Creating a quick Todo listing app on Windows using IIS7, Node.js and Mongodb

As I mentioned in my last post, more and more organizations are leaning towards Web Oriented Architecture (WOA) which are highly scalable. If you were exploring cool, scalable options to build highly performing web applications, you know what Node.js is for.After following the recent post from Scott Hanselman, I was up and running quickly with Node.js. In this post, I’ll explain step by step how I’ve setup Node.js and Mongodb to create a simple Todo listing application.Setting up Node.jsThis is what I’ve done.1 – Goto, scroll down and download node.exe for Windows, and place it in your c:\node folder2 – Goto IIS Node project in Git at, download the correct ‘retail’ link of IIS Node zip file (I downloaded the already built retail package, otherwise you can download and build from the source).3 – Extract the zip file some where, and run the install.bat or install_iisexpress.bat depending on your IIS Version. If you don’t have IIS in…

Top 7 Coding Standards & Guideline Documents For C#/.NET Developers

Some time back, I collated a list of 7 Must Read, Free EBooks for .NET Developers, and a lot of people found it useful. So, I thought about putting together a list of Coding Standard guidelines/checklists for .NET /C# developers as well.As you may already know, it is easy to come up with a document - the key is in implementing these standards in your organization, through methods like internal trainings, Peer Reviews, Check in policies, Automated code review tools etc. You can have a look at FxCop and/or StyleCop for automating the review process to some extent, and can customize the rules based on your requirements.Anyway, here is a list of some good Coding Standard Documents. They are useful not just from a review perspective - going through these documents can definitely help you and me to iron out few hidden glitches we might have in the programming portion of our brain. So, here we go, the listing is not in any specific order.1 – IDesign C# Coding StandardsIDesign C# coding stand…