0

0

C#怎么使用GeneratedRegex C# 7正则表达式源生成器

煙雲

煙雲

发布时间:2025-12-15 16:52:04

|

251人浏览过

|

来源于php中文网

原创

GeneratedRegex 是 .NET 7 引入的正则表达式源生成器,编译时将字符串字面量转换为高效、类型安全的静态方法,避免运行时编译开销和反射,提升性能并增强 IDE 支持。

c#怎么使用generatedregex c# 7正则表达式源生成器

GeneratedRegex 是 .NET 7 引入的正则表达式源生成器(Source Generator),它在编译时将 Regex 字符串字面量自动转换为高效、类型安全的静态方法,避免运行时编译开销和反射,提升性能并增强 IDE 支持(如智能提示、编译期错误检查)。

启用 GeneratedRegex 特性

确保项目使用 .NET 7 或更高版本,并在 .csproj 文件中启用正则源生成:


  net7.0
  true

也可显式引用 System.Text.RegularExpressions.Generators(通常不需要,SDK 已内置)。

用 [GeneratedRegex] 标记静态 Regex 属性或方法

只需给一个 static Regex 字段/属性或返回 Regex 的静态方法加上 [GeneratedRegex] 特性,编译器就会自动生成优化实现:

✅ 推荐写法(属性):

using System.Text.RegularExpressions;

public static class Patterns { [GeneratedRegex(@"\d{3}-\d{2}-\d{4}")] // 社保号格式 public static partial Regex SsnRegex(); }

✅ 方法也支持(更灵活,可传选项):

[GeneratedRegex(@"\b\w+\b", RegexOptions.IgnoreCase)]
public static partial Regex WordRegex();

⚠️ 注意:

Vinteo AI
Vinteo AI

利用人工智能在逼真的室内环境中创建产品可视化。无需设计师和产品照片拍摄

下载
  • 必须是 static partial 方法,返回 Regex(不能是字段或普通属性)
  • 正则模式必须是编译期常量字符串(不能拼接、不能变量)
  • 支持大多数 RegexOptions,但不支持 Compiled(源生成本身已“编译”)

直接调用生成的方法,无需 new Regex

生成的代码会提供高性能的匹配入口,例如:

var match = Patterns.SsnRegex().Match("123-45-6789");
// 或更推荐:用扩展方法(自动生成)——需 using System.Text.RegularExpressions;
bool isValid = "123-45-6789".IsMatch(Patterns.SsnRegex());

实际上,源生成器还会为该 Regex 自动添加一组强类型的扩展方法,比如:

  • IsMatch(ReadOnlySpan)
  • Match(ReadOnlySpan)
  • Matches(ReadOnlySpan)
  • 带捕获组名称的 MatchAs()(需配合 RegexGeneratorOptions 启用)

进阶:启用命名捕获组解析(.NET 8+ 更完善,.NET 7 可用但有限)

.NET 7 的 GeneratedRegex 对命名组支持基础,若需强类型访问捕获内容,可搭配 RegexGeneratorOptions(需手动指定):

[GeneratedRegex(@"(?\d{4})-(?\d{2})-(?\d{2})", 
    RegexOptions.None, 
    "MyDateRegex")]
public static partial Regex DateRegex();

然后可通过 DateRegex().Match(...).GetGroup("year") 安全访问;.NET 8 进一步支持 MatchAs() 自动生成结构体解构。

基本上就这些。不用手写 new Regex(...),不担心运行时异常,IDE 能跳转到正则、高亮语法、实时验证——GeneratedRegex 让正则真正融入 C# 的静态世界。

相关专题

更多
js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

510

2023.06.20

正则表达式不包含
正则表达式不包含

正则表达式,又称规则表达式,,是一种文本模式,包括普通字符和特殊字符,是计算机科学的一个概念。正则表达式使用单个字符串来描述、匹配一系列匹配某个句法规则的字符串,通常被用来检索、替换那些符合某个模式的文本。php中文网给大家带来了有关正则表达式的相关教程以及文章,希望对大家能有所帮助。

248

2023.07.05

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

741

2023.07.05

java正则表达式匹配字符串
java正则表达式匹配字符串

在Java中,我们可以使用正则表达式来匹配字符串。本专题为大家带来java正则表达式匹配字符串的相关内容,帮助大家解决问题。

213

2023.08.11

正则表达式空格
正则表达式空格

正则表达式空格可以用“s”来表示,它是一个特殊的元字符,用于匹配任意空白字符,包括空格、制表符、换行符等。本专题为大家提供正则表达式相关的文章、下载、课程内容,供大家免费下载体验。

351

2023.08.31

Python爬虫获取数据的方法
Python爬虫获取数据的方法

Python爬虫可以通过请求库发送HTTP请求、解析库解析HTML、正则表达式提取数据,或使用数据抓取框架来获取数据。更多关于Python爬虫相关知识。详情阅读本专题下面的文章。php中文网欢迎大家前来学习。

293

2023.11.13

正则表达式空格如何表示
正则表达式空格如何表示

正则表达式空格可以用“s”来表示,它是一个特殊的元字符,用于匹配任意空白字符,包括空格、制表符、换行符等。想了解更多正则表达式空格怎么表示的内容,可以访问下面的文章。

234

2023.11.17

正则表达式中如何匹配数字
正则表达式中如何匹配数字

正则表达式中可以通过匹配单个数字、匹配多个数字、匹配固定长度的数字、匹配整数和小数、匹配负数和匹配科学计数法表示的数字的方法匹配数字。更多关于正则表达式的相关知识详情请看本专题下面的文章。php中文网欢迎大家前来学习。

528

2023.12.06

PS使用蒙版相关教程
PS使用蒙版相关教程

本专题整合了ps使用蒙版相关教程,阅读专题下面的文章了解更多详细内容。

23

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
AngularJS教程
AngularJS教程

共24课时 | 2.7万人学习

【李炎恢】ThinkPHP8.x 后端框架课程
【李炎恢】ThinkPHP8.x 后端框架课程

共50课时 | 4.5万人学习

Swoft2.x速学之http api篇课程
Swoft2.x速学之http api篇课程

共16课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号