Ported as conceptual article from .NET dev blog: Regex enhancements with .NET 7

docfx.json

@@ -1,6 +1,15 @@
 {
     "build": {
-        "markdownEngineName": "markdig",
+      "markdownEngineName": "markdig",
+      "markdownEngineProperties": {
+        "markdigExtensions": [
+            "abbreviations",
+            "definitionlists",
+            "tasklists",
+            "footnotes",
+            "diagrams"
+          ]
+        },
         "content": [
             {
                 "files": ["api/**/*.md"]

docs/fundamentals/toc.yml

@@ -2251,6 +2251,9 @@ items:
     - name: Overview
       href: ../standard/base-types/regular-expressions.md
       displayName: regular expressions
+    - name: Source generation
+      href: ../standard/base-types/regular-expression-source-generators.md
+      displayName: regular expressions,advanced,design concepts,source generators,algorithmic reduction,regex
     - name: Language reference
       items:
       - name: Overview

docs/standard/base-types/regular-expressions.md

@@ -23,6 +23,7 @@ helpviewer_keywords:
   - "strings [.NET], regular expressions"
 ms.assetid: 521b3f6d-f869-42e1-93e5-158c54a6895d
 ---
+
 # .NET regular expressions
 
 Regular expressions provide a powerful, flexible, and efficient method for processing text. The extensive pattern-matching notation of regular expressions enables you to quickly parse large amounts of text to:

docs/standard/base-types/snippets/regular-expression-source-generators/Program.cs

@@ -0,0 +1,64 @@
+using System.Text;
+using System.Text.RegularExpressions;
+
+static partial class Program
+{
+    private static readonly Regex s_abcOrDefGeneratedRegex = AbcOrDefGeneratedRegex();
+
+    [GeneratedRegex(
+        pattern: "abc|def",
+        options: RegexOptions.IgnoreCase | RegexOptions.Compiled,
+        cultureName: "en-US")]
+    private static partial Regex AbcOrDefGeneratedRegex();
+
+    private static void EvaluateText(string text)
+    {
+        if (s_abcOrDefGeneratedRegex.IsMatch(text))
+        {
+            Console.WriteLine($"""
+                ✅ "{text}" matches "{s_abcOrDefGeneratedRegex}" pattern.
+                """);
+        }
+        else
+        {
+            Console.WriteLine($"""
+                ❌ "{text}" doesn't match "{s_abcOrDefGeneratedRegex}" pattern.
+                """);
+        }
+    }
+
+    private static void Main()
+    {
+        Console.OutputEncoding = Encoding.UTF8;
+
+        new List<string> { "Incubus", "Deftones", "Tool" }.ForEach(EvaluateText);
+
+        // Sample output:
+        //   ❌ "Incubus" doesn't match "abc|def" pattern.
+        //   ✅ "Deftones" matches "abc|def" pattern.
+        //   ❌ "Tool" doesn't match "abc|def" pattern.
+
+        var abcOrDefRegex = new Regex(pattern: "abc|def", options: RegexOptions.IgnoreCase);
+    }
+}
+
+static file partial class Program
+{
+    [GeneratedRegex(pattern: @"(a|bc)d")]
+    private static partial Regex ExampleRegex();
+
+    [GeneratedRegex(pattern: "[ab]*[bc]")]
+    private static partial Regex AnotherExampleRegex();
+
+    [GeneratedRegex(pattern: "Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday")]
+    private static partial Regex DaysOfWeekRegex();
+
+    [GeneratedRegex(pattern: "")]
+    private static partial Regex BlankRegex();
+
+    [GeneratedRegex(pattern: @"^([a-zA-Z0-9_\-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([a-zA-Z0-9\-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$")]
+    private static partial Regex EmailRegex();
+
+    [GeneratedRegex(pattern: "(\\w)\\1")]
+    private static partial Regex WordWithBacktrackingRegex();
+}

docs/standard/base-types/snippets/regular-expression-source-generators/regex.csproj

@@ -0,0 +1,10 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net7.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+</Project>