Source Generators and regular expressions

Source Generators and regular expressions

Source Generators and Regular Expressions

Since .NET 7 we have the possibility to use source generators for regular expressions. The first question is: What is a source generator? I can quote here the official Microsoft page:

... Source Generators let C# developers inspect user code as it is being compiled. The generator can create new C# source files on the fly that are added to the user's compilation. In this way, you have code that runs during compilation. It inspects your program to produce additional source files that are compiled together with the rest of your code.

In simple terms: Source generators hook into the build process and can create additional stuff. And that is where our journey starts with regular expressions. If we define a regular expression, that regular expression can be expressed as code. This happens when you hit the build button.

The advantage over the traditional approach is that we can get the same performance as new Regex("...", RegexOptions.Compiled) and the startup benefit of Regex.CompileToAssembly, but without the complexity of CompileToAssembly (not from a user point of view but how the regex is embedded into the assembly). As the code is generated it can be viewed and debugged.

So instead of this code:

private static readonly Regex HelloOrWorldCompiled =
        new("Hello|World", RegexOptions.Compiled | RegexOptions.IgnoreCase | RegexOptions.CultureInvariant);

We can write it like this:

[GeneratedRegex("Hello|World", RegexOptions.IgnoreCase | RegexOptions.CultureInvariant)]
private static partial Regex HelloOrWorldGenerator();

Two things are essential here:

  1. We have to use the GeneratedRegexAttribute to tell the source generator where it should hook in.
  2. Instead of a field, we now have a partial method. The reason is that the source generator has to extend something. You can not extend fields, but you can extend partial methods.

Now you might have noticed that I omitted the RegexOptions.Compiled flag from the generated version. Why is that? Well, that flag tells the .NET runtime to compile a regular expression when your application starts. It is now part of your assembly, with the new source generators, that will always be the case. There is no "on the fly" anymore.

The usage is almost the same:



They behave exactly the same and offer the same functions. One cool thing is that the source generator also creates XML documentation that explains exactly what it is doing.

xml doc


The new regular expression source generators are an excellent and convenient addition to the .NET ecosystem.