Skip to main content

Roslyn September CTP 2012 Overview – API Changes, Using Modified APIs for C# Script Execution, Embedding C# as a scripting language

imageMicrosoft Roslyn September CTP 2012 is now released. You can download the September CTP here

You could find a quick overview about Roslyn in my previous overview post.

Roslyn CTP previews the upcoming features of C# and VB.NET. Roslyn CTP is a pretty exciting release, and it opens up lot of possibilities for C# and VB.NET programmers. Roslyn provides language services and APIs on top of .NET’s compiler services, and this will enable .NET developers to do a lot more things – including using C# and VB.NET as scripting languages, use compiler as a service in your own applications for code related tasks, develop better language and IDE extensions etc.

What’s Exciting In September CTP (CTP3) release

One of the biggest excitement for me is the support for Expression Trees. This means, now you can include LINQ Queries in your script, and you can dynamically execute LINQ queries. This has lot of interesting aspects, and this is huge. For example, see how I’m executing a very simple Linq query from the C# interactive console.


Along with inclusion of Expression trees, the following language features are also now supported in Roslyn, since CTP2.

  • Collection initializers
  • Extern aliases
  • Multi-dimensional arrays
  • Nullable types
  • Object initializers
  • Type forwarders
  • Unsafe code (except fixed-size buffers)

Scripting API Changes

There are some breaking changes in September CTP release. I thought I’ll quickly re-phrase the Scripting Example I provided in the overview post. Some of the major changes for Scripting API includes,

  • Changes for the ScriptEngine constructor
  • Now you need to use ScriptEngine instance’s Create Method instead of Session.Create(..) you had in earlier version of Roslyn.
  • The Execute method is now part of the Session, instead of Engine. So, instead of Engine’s Execute(code,session) in previous versions, you can directly call your Session’s Execute(code) method.

So, here is the updated code for the Scripting example I provided in the previous post. You could compare this with the previous example, and I’ve listed some of the changes below. Note that the change is only with in the ScriptingHost class

using System;
using System.Collections.Generic;
using System.Linq;
using Roslyn.Scripting.CSharp;
using Roslyn.Scripting;

namespace ScriptingRoslyn
    //Our Dog class so that we can train dogs later
    public class OurDog
        private string _name = string.Empty;
        public OurDog(string name)
            _name = name;

        public string Name
            get { return _name; }

        public void Bite(OurDog other)
            Console.WriteLine("{0} is biting the tail of {1}", _name, other.Name);

        public void Walk()
            Console.WriteLine("{0} is Walking", _name);

        public void Eat()
            Console.WriteLine("{0} is Eating", _name);

//Let us create a Host object, where we'll wrap our session and engine
//The methods in the host class are available directly to the environment
//Now you can create a ScriptEngine, and create a session out of the ScriptEngine

 public class ScriptingHost
        private ScriptEngine engine;
        private Session session;

        //Methods in the Host object can be called directly from the 
        public OurDog CreateDog(string name)
            return new OurDog(name);

        public ScriptingHost()
            //Create the script engine
            //Script engine constructor parameters go changed
            engine=new ScriptEngine();

            //Let us use engine's Addreference for adding the required
                    typeof (Console).Assembly,
                    typeof (ScriptingHost).Assembly,
                    typeof (IEnumerable<>).Assembly,
                    typeof (IQueryable).Assembly,
             }.ToList().ForEach(asm => engine.AddReference(asm));

                   "System", "System.Linq", 

            //Now, you need to create a session using engine's CreateSession method,
            //which can be seeded with a host object
            session = engine.CreateSession(this);

        //Pass the code to the engine, nothing much here
        public object Execute(string code)
            return session.Execute (code);

        public T Execute<T>(string code)
            return session.Execute<T>(code);


    //Main driver
    class Program
        static void Main(string[] args)
            var host = new ScriptingHost();
            Console.WriteLine("Hello Dog Trainer!! Type your code.\n\n");

            string codeLine;
            while ((codeLine = Console.ReadLine()) != "Exit();")
                    //Execute the code
                    var res = host.Execute(codeLine);

                    //Write the result back to console
                    if (res != null)
                        Console.WriteLine(" = " + res.ToString());
                catch (Exception e)
                    Console.WriteLine(" !! " + e.Message);


And now, let us run our little scripting app. And try some LINQ queries as part of your script Smile



Other API Changes

There have been some updates to the Roslyn APIs since the second CTP was released in June of 2012. Below is a summary of some of the most important changes, some of which are breaking.  For example, In compiler APIs,

  • Instead of SyntaxTree.ParseCompilationUnit you can use ParseText or ParseFile instead. 
  • Also SyntaxNode.GetText and SyntaxNode.GetFullText have been replaced with ToString and ToFullString respectively

You can see a full list of API changes here - Happy Hacking with the new Roslyn APIs, Enjoy C#

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…