Skip to main content

Simple but effective use of C# Source Generators

Most C# source generator examples I have encountered included more advanced features like augmenting existing classes with generated code. There are much simpler scenarios where they are useful though. For instance, just avoiding typing repetitive code. For the full source code, consult my GitHub repo here.

Imagine writing a number of overloads where only the function name changes. In this case, I want to create HTML tags as strings using a function. The example is a set of overloads for the anchor ('a') tag:

public static Node a(params Node[] nodes) =>
    element(nameof(a), Array.Empty<IAttribute>(), nodes);
public static Node a(params IAttribute[] attributes) =>
    element(nameof(a), attributes, Array.Empty<Node>());
public static Node a(IEnumerable<IAttribute> attributes, params Node[] children) =>
    element(nameof(a), attributes, children);

Now I want the have the same overloads for all HTML tags. That's a lot of repetition. To create a source generator for this all I basically have to do is create a text template for the above. Now I am not going to describe the nuts and bolts of C# source generators because there is plenty of documentation. So I will only show the source of the generator here:

public class ElementsGenerator : ISourceGenerator
    private string GetElementMethods(string tagName) =>
            public static Node {tagName}(params Node[] nodes) =>
                element(nameof({tagName}), Array.Empty<IAttribute>(), nodes);

            public static Node {tagName}(params IAttribute[] attributes) =>
                element(nameof({tagName}), attributes, Array.Empty<Node>());

            public static Node {tagName}(IEnumerable<IAttribute> attributes, params Node[] children) =>
                element(nameof({tagName}), attributes, children);

    public void Execute(GeneratorExecutionContext context)
        string[] tagNames = new string[]
            "a", "abbr", "acronym", "address", "applet", "area", "article", "aside", "audio", "b", "@base", "basefont",
            "bdi", "bdo", "big", "br", "button", "canvas", "caption", "center", "cite", "code", "col", "colgroup", "content",
            "data", "datalist", "dd", "del", "details", "dfn", "dialog", "dir", "div", "dl", "dt", "em", "embed", "fieldset", "figcaption",
            "figure", "font", "footer", "form", "frame", "fraeset", "h1", "h2", "h3", "h4", "h5", "h6", "head", "header", "hr", "html",
            "i", "iframe", "img", "input", "ïns", "kbd", "label", "legend", "li", "link", "main", "map", "mark", "menu", "menuitem",
            "meta", "meter", "nav", "noembed", "noframes", "noscript", "@object", "ol", "optgroup", "option", "output", "p", "param",
            "picture", "pre", "progress", "q", "rb", "rp", "rt", "rtc", "ruby", "s", "samp", "script", "section", "select", "shadow", "slot",
            "small", "source", "span", "strike", "strong", "style", "sub", "summary", "sup", "svg", "table", "tbody", "td", "template", "text",
            "textarea", "tfoot", "th", "thead", "time", "title", "tr", "track", "tt", "u", "ul", "var", "video", "wbr"

        var methodsStringBuilder = new StringBuilder();

        for (int i = 0; i < tagNames.Length; i++)

        string classText =
            using System;

            namespace Radix.Components.Html;

            public static partial class Elements
                public static Node text(string text) => new Text(text);

                public static Concat concat(params Node[] nodes) => new(nodes);

                public static Element element(Name name, IEnumerable<IAttribute> attributes, params Node[] children) => new(name, attributes, children);


        // Register the source
        context.AddSource("Elements", classText);

    public void Initialize(GeneratorInitializationContext context) { }

As you can see, the only method that is implemented is the execute method and the only thing it does is adding generated code to the compilation of the project where the generator project is included.


Popular posts from this blog

Running Microsoft Playwright in an Azure Function using C#

When you have tried to run MS Playwright using C# in the context of an Azure Function, you probably have run into this message: The driver it is referring to resides in the .playwright folder that is copied to the build output folder. Now, the output folder structure of an Azure Function project is different from most projects in the sense that there is an extra nested bin folder where the drivers should actually be copied.  The build target that the Playwright team uses, at the time of writing (version 1.15.4), always copies the folder containing the driver to the root of the output folder. So the fix here is to add an extra build target to your project file, the corrects for the extra nested folder:   <Target Name="FixPlaywrightCopyAfterBuild" AfterTargets="Build">     <ItemGroup>       <_BuildCopyItems Include="$(OutDir).playwright\**" />     </ItemGroup>     <Message Text="[Fix] Copying files to the nested bin folder o

Type aliases using C# Source Generators and C# 10 generic attributes

When practicing domain-driven design, a reoccurring chore is the creation of value types. These are strongly typed representations of simple types like strings that have a specific meaning, like CustomerId or ProductCode. These could both be strings but we put preferably implement them as strongly typed variations so that we can't for instance mix up multiple string parameters while coding. In some languages, this is something that comes out of the box and is often referred to as type aliasing. C# does not support this. Although in C# you could give another name to a string type with a using statement, it still remains a string (the type does not change).  This task is so common and tedious that it makes it the perfect case for implementing a source generator. Creating a type alias should be as simple as adding an attribute indicating what type should be aliased. It should also work for all kinds of types, like class, record, struct, and record struct. The full source code can be f