C# 正则表达式
正则表达式テキストパターンを記述・照合するための検索式です。簡単に言うと、特殊なワイルドカード言語のようなもので、文字列内の内容を正確に検索、検証、または置換するために使います。
例えば、ユーザー入力が有効なメールアドレスや電話番号であるかどうかを判断したり、テキストからすべての日付を抽出したり——これらはすべて正規表現の典型的な用途です。
.NET フレームワークには機能が充実した正規表現エンジンが組み込まれており、System.Text.RegularExpressions名前空間がサポートを提供します。
正規表現パターンは、1つ以上の文字、演算子、構造体で構成され、それらが一致させるテキストの規則をまとめて記述します。
正規表現をまだ理解していない場合は、まず当サイトの正则表达式 - 教程。
正規表現を定義する
正規表現は以下の種類の構成要素からなり、各種類が異なるマッチング機能を担います:
- 字符转义:特殊文字を通常の文字として扱わせる(例:
\.実際のピリオドに一致する) - 字符类:特定の「種類」の文字にマッチします(例:
\d任意の数字に一致する) - 定位点:マッチが発生する「位置」を指定します(例:
^表示行首) - 分组构造:サブパターンをグループ化して、キャプチャや参照を容易にする
- 限定符:特定の要素の出現回数を制御します(例:
+1回以上の繰り返しを表す) - 反向引用构造:以前にキャプチャした内容を参照して再度マッチングする
- 备用构造:「または」の論理を実装します(例:
cat|dog) - 替换:置換操作でキャプチャした内容を参照します
- 杂项构造:インラインオプション、コメントなどの補助機能
字符转义
正規表現では、バックスラッシュ文字(\)には2つの役割があります。1つは、その後の普通字符变成特殊含义(如\n改行を表す)、もう1つは特殊文字をリテラル文字にエスケープする(如\.実際のドット文字をマッチングし、「任意の文字」ではなくなる)。
初心者によくある誤解:C# の文字列では、\自体もエスケープ文字であるため、正規表現では\d、C# の文字列では"\\d"、または verbatim 文字列を使用します@"\d"(推荐)。
次の表は、よく使われるエスケープ文字の一覧です:
| 转义字符 | 描述 | 模式 | 匹配 |
|---|---|---|---|
| \a | ベル文字 \u0007 と一致します。 | \a | "Warning!" + '\u0007' の中の "\u0007" |
| \b | 文字クラス内では、バックスペース \u0008 と一致します。(注意:文字クラス外では、\b は単語境界を表します。「アンカー」のセクションを参照) | [\b]{3,} | "\b\b\b\b" の中の "\b\b\b\b" |
| \t | タブ文字 \u0009 と一致します。タブ区切りテキストのマッチングによく使用されます。 | (\w+)\t | "Name\tAddr\t" の中の "Name\t" と "Addr\t" |
| \r | キャリッジリターン \u000D と一致します。(\r と改行文字 \n は同等ではありません。Windows の改行は通常 \r\n です) | \r\n(\w+) | "\r\nHello\nWorld." の中の "\r\nHello" |
| \v | 垂直タブ \u000B と一致します。 | [\v]{2,} | "\v\v\v" の中の "\v\v\v" |
| \f | 改ページ文字 \u000C と一致します。 | [\f]{2,} | "\f\f\f" の中の "\f\f\f" |
| \n | 改行文字 \u000A と一致します。Unix/Linux システムの行末は通常 \n のみです。 | \r\n(\w+) | "\r\nHello\nWorld." の中の "\r\nHello" |
| \e | エスケープ文字 \u001B と一致します。 | \e | "\x001B" の中の "\x001B" |
| \ nnn | 8進数表現を使用して文字を指定します(nnn は2〜3桁の数字で構成されます)。 | \w\040\w | "a bc d" の中の "a b" と "c d" |
| \x nn | 16進数表現を使用して文字を指定します(nn はちょうど2桁の数字で構成されます)。 | \w\x20\w | "a bc d" の中の "a b" と "c d" |
| \c X \c x | X または x で指定される ASCII 制御文字と一致します。ここで X または x は制御文字のアルファベットです。 | \cC | "\x0003" の中の "\x0003" (Ctrl-C) |
| \u nnnn | 16進数表現を使用して Unicode 文字(nnnn で表される4桁の数字)と一致します。 | \w\u0020\w | "a bc d" の中の "a b" と "c d" |
| \ | 後ろに認識されないエスケープ文字が続く場合、その文字と一致します。 | \d+[\+-x\*]\d+\d+[\+-x\*\d+ | "(2+2) * 3*9" の中の "2+2" と "3*9" |
字符类
文字クラスは「ある種類」の文字のうち任意一个。例如[aeiou]任意の母音文字1つにマッチします。\d任意の1つの数字と一致します。これは正規表現で最もよく使われる基本機能の1つです。
次の表に文字クラスを示します:
| 字符类 | 描述 | 模式 | 匹配 |
|---|---|---|---|
| [character_group] | character_group 内の任意の単一文字と一致します。既定では、マッチングは大文字と小文字を区別します。 | [mn] | "mat" の "m"、"moon" の "m" と "n" |
| [^character_group] | 否定:character_group 内にない任意の単一文字と一致します。既定では、character_group 内の文字は大文字と小文字を区別します。 | [^aei] | "avail" の "v" と "l" |
| [ first - last ] | 文字範囲:first から last までの範囲内の任意の単一文字と一致します。 | [b-d] | [b-d]irds 可以匹配 Birds、 Cirds、 Dirds |
| . | ワイルドカード:\n 以外の任意の単一文字と一致します。 本来の意味のピリオド文字(. または \u002E)と一致させるには、その文字の前にエスケープ文字(\.)を付ける必要があります。 | a.e | "have" の "ave"、"mate" の "ate" |
| \p{ name } | とname指定された Unicode 一般カテゴリまたは名前付きブロック内の任意の単一文字と一致します。 | \p{Lu} | "City Lights" の中の "C" と "L" |
| \P{ name } | と不にname指定された Unicode 一般カテゴリまたは名前付きブロック内の任意の単一文字と一致します。 | \P{Lu} | "City" の中の "i"、"t"、"y" |
| \w | 任意の単語文字(英字、数字、アンダースコア)と一致します。[a-zA-Z0-9_](ASCII 範囲内)と同等です。 | \w | "Room#1" の中の "R"、"o"、"m" と "1" |
| \W | 任意の非単語文字と一致します。\w の否定です。 | \W | "Room#1" の中の "#" |
| \s | 任意の空白文字(スペース、タブ、改行など)と一致します。 | \w\s | "ID A1.3" の "D " |
| \S | 任意の非空白文字と一致します。\s の否定です。 | \s\S | 「int __ctr」の中の「_」 |
| \d | 任意の10進数字と一致します。[0-9] と同等です。 | \d | "4 = IV" の中の "4" |
| \D | 10進数字ではない任意の文字と一致します。\d の否定です。 | \D | "4 = IV" の " "、 "="、 " "、 "I" と "V" |
定位点
アンカー(「錨」とも呼ばれます)は具体的な文字とは一致せず、文字列内の特定の位置。これらは「ゼロ幅」であり、文字を消費せず、現在の位置が特定の条件を満たしていることを表明するだけです。
例如^\d{3}「文字列の先頭にある3つの数字」を表します。\b「単語文字と非単語文字の間の境界」を表します。
次の表にアンカーを示します:
| 断言 | 描述 | 模式 | 匹配 |
|---|---|---|---|
| ^ | マッチは文字列または行の先頭から始まる必要があります。 | ^\d{3} | 「567-777-」の中の「567」 |
| $ | マッチは文字列の末尾、または行もしくは文字列末尾の\n之前。 | -\d{4}$ | "8-12-2012" の中の "-2012" |
| \A | マッチは文字列の先頭に出現する必要があります(複数行モードの影響を受けず、常に文字列全体の先頭です)。 | \A\w{4} | "Code-007-" の中の "Code" |
| \Z | マッチは文字列の末尾、または文字列末尾の\n之前。 | -\d{3}\Z | "Bond-901-007" の中の "-007" |
| \z | マッチは文字列の末尾に出現する必要があります(厳密な末尾で、末尾に \n は許可されません)。 | -\d{3}\z | "-901-333" の "-333" |
| \G | マッチは前のマッチが終了した場所に出現する必要があります。連続マッチングのシナリオでよく使用されます。 | \G\(\d\) | "(1)(3)(5)[7](9)" 中の "(1)"、 "(3)" と "(5)" |
| \b | 単語境界と一致します。つまり、単語と空白の間の位置のことです。 | er\b | "never" の中の "er" にマッチするが、"verb" の中の "er" にはマッチしない。 |
| \B | 単語の境界以外と一致します。 | er\B | "verb" の中の "er" にマッチするが、"never" の中の "er" にはマッチしない。 |
分组构造
グループ化構造は丸括弧を使用します( )正規表現の一部を括弧で囲み、部分式を形成します。グループ化には主に2つの用途があります:
- 捕获:一致した部分文字列を「保存」して、後で抽出したり置換内で参照したりできるようにします。
- 作用域限定:量指定子や代替構造をグループ内の部分式にのみ作用させます。
この部分は理解しにくいので、正则表达式-选择 、正規表現の先行断言(lookahead)と後行断言(lookbehind)帮助理解。
次の表は、グループ化構造の一覧です:
| 分组构造 | 描述 | 模式 | 匹配 |
|---|---|---|---|
| ( subexpression ) | 一致した部分式をキャプチャし、ゼロから始まる序数に割り当てます。 | (\w)\1 | 「deep」の中の「ee」 |
| (?< name >subexpression) | マッチした部分式を名前付きグループにキャプチャします。名前付きグループは数字の番号より読みやすいため、複雑な正規表現での使用をお勧めします。 | (?< double>\w)\k< double> | 「deep」の中の「ee」 |
| (?< name1 -name2 >subexpression) | 平衡グループ定義を定義します。ネストされた構造(括弧のペアなど)のマッチングに使用され、高度な機能です。 | (((?'Open'\()[^\(\)]*)+((?'Close-Open'\))[^\(\)]*)+)*(?(Open)(?!))$ | 「3+2^((1-3)*(3-1))」の中の「((1-3)*(3-1))」 |
| (?: subexpression) | 非キャプチャグループを定義します。グループ化(範囲の限定)だけでマッチ内容の保存が不要な場合に使用され、キャプチャグループよりわずかにパフォーマンスが優れています。 | Write(?:Line)? | "Console.WriteLine()" の "WriteLine" |
| (?imnsx-imnsx:subexpression) | 应用或禁用subexpressionで指定されたオプション。 | A\d{2}(?i:\w+)\b | "A12xl A12XL a12xl" の中の "A12xl" と "A12XL" |
| (?= subexpression) | ゼロ幅の正の先読みアサーション(lookahead)。後に subexpression が続く位置と一致しますが、文字は消費しません。 | \w+(?=\.) | "He is. The dog ran. The sun is out." の中の "is"、"ran"、"out" |
| (?! subexpression) | ゼロ幅の負の先読みアサーション。後に subexpression が続かない位置と一致します。 | \b(?!un)\w+\b | "unsure sure unity used" の中の "sure" と "used" |
| (?<=subexpression) | ゼロ幅の正の後読みアサーション(lookbehind)。前に subexpression が直接続く位置と一致します。 | (?<=19)\d{2}\b | "1851 1999 1950 1905 2003" の中の "99"、"50"と "05" |
| (?<! subexpression) | ゼロ幅の負の後読みアサーション。前に subexpression が続かない位置と一致します。 | (?<!wo)man\b | "Hi woman Hi man" の中の "man" |
| (?> subexpression) | バックトラックしない(原子グループ)部分式。マッチ成功後にバックトラックを許可しないため、特定のシナリオでパフォーマンスを向上できます。 | [13579](?>A+B+) | "1ABB 3ABBC 5AB 5AC" の中の "1ABB"、"3ABB" と "5AB" |
实例
using System.Text.RegularExpressions;
public class Example
{
public static void Main()
{
string input = "1851 1999 1950 1905 2003";
string pattern = @"(?<=19)\d{2}\b";
foreach (Match match in Regex.Matches(input, pattern))
Console.WriteLine(match.Value);
}
}
限定符
量指定子は、前の要素(文字、文字クラス、またはグループ)が出現する必要があることを指定します。多少次初めて一致成功となります。
量指定子はデフォルトで貪欲な、つまり可能な限り多くの文字をマッチングします。量指定子の後に?になり得る懒惰(非贪婪)モードを付けると、つまり可能な限り少ない文字をマッチングします。初心者はまず*、+、?、{n}これら4つの基本量指定子。
次の表に量指定子を示します:
| 限定符 | 描述 | 模式 | 匹配 |
|---|---|---|---|
| * | 前の要素に0回以上一致します。(0回でも一致とみなされます) | \d*\.\d | ".0"、 "19.9"、 "219.9" |
| + | 前の要素に1回以上一致します。(少なくとも1回) | "be+" | "been" の中の "bee"、"bent" の中の "be" |
| ? | 前の要素に0回または1回一致します。(つまり、その要素は省略可能) | "rai?n" | "ran"、 "rain" |
| { n } | 直前の要素にちょうど n 回マッチします。 | ",\d{3}" | "1,043.6" の ",043"、"9,876,543,210" の ",876"、",543" と ",210" |
| { n ,} | 直前の要素に少なくとも n 回マッチします。 | "\d{2,}" | "166"、 "29"、 "1930" |
| { n , m } | 前の要素に少なくとも n 回、ただし m 回以下で一致します。 | "\d{3,5}" | "166"、"17668"、 "193024" の中の "19302" |
| *? | 前の要素に0回以上一致しますが、回数はできるだけ少なくなります(怠惰モード)。 | \d*?\.\d | ".0"、 "19.9"、 "219.9" |
| +? | 前の要素に1回以上一致しますが、回数はできるだけ少なくなります(怠惰モード)。 | "be+?" | "been" の中の "be"、"bent" の中の "be" |
| ?? | 前の要素に0回または1回一致しますが、回数はできるだけ少なくなります(怠惰モード)。 | "rai??n" | "ran"、 "rain" |
| { n }? | 直前の要素にちょうど n 回マッチします。 | ",\d{3}?" | "1,043.6" の ",043"、"9,876,543,210" の ",876"、",543" と ",210" |
| { n ,}? | 前の要素に少なくとも n 回一致しますが、回数はできるだけ少なくなります。 | "\d{2,}?" | "166"、"29" と "1930" |
| { n , m }? | 前の要素に n 回以上 m 回以下で一致しますが、回数はできるだけ少なくなります。 | "\d{3,5}?" | "166"、"17668"、 "193024" の中の "193" と "024" |
後方参照構造
後方参照により、同じ正規表現内で前にキャプチャされたグループの内容再マッチを行います。例えば、(\w)\1「ee」や「ll」のような連続して繰り返される文字を見つけることができます。
次の表は、後方参照構造の一覧です:
| 後方参照構造 | 描述 | 模式 | 匹配 |
|---|---|---|---|
| \ number | 後方参照。番号付き部分式の値と一致します。 | (\w)\1 | 「seek」の中の「ee」 |
| \k< name > | 名前付き後方参照。名前付き式の値にマッチします。数字による参照より読みやすいため、使用をお勧めします。 | (?< char>\w)\k< char> | 「seek」の中の「ee」 |
备用构造
代替構造は縦棒を使用します|「または」の論理を実装し、正規表現が複数の候補パターンのいずれかに一致できるようにします。プログラミング言語の||运算符。
次の表は、代替構造の一覧です:
| 备用构造 | 描述 | 模式 | 匹配 |
|---|---|---|---|
| | | 縦棒 (|) 文字で区切られた任意の1つの要素と一致します。 | th(e|is|at) | "this is the day. " の中の "the" と "this" |
| (?( expression )yes | no ) | 正規表現パターンが expression のマッチによって指定される場合、一致するのはyes;それ以外の場合はオプションのno部分です。expression はゼロ幅アサーションとして解釈されます。 | (?(A)A\d{2}\b|\b\d{3}\b) | "A10 C103 910" の中の "A10" と "910" |
| (?( name )yes | no ) | name または名前付き・番号付きキャプチャグループにマッチがある場合、yes;それ以外の場合はオプションのno。 | (?< quoted>")?(?(quoted).+?"|\S+\s) | "Dogs.jpg "Yiska playing.jpg"" の中の Dogs.jpg と "Yiska playing.jpg" |
替换
置換構文は〜に使用されますRegex.Replace()方法の替换模式字符串で、〜することができます$番号または名前を使用して以前にキャプチャしたグループ内容を参照し、柔軟なテキスト再構成を実現します。
次の表は、置換に使用する文字の一覧です:
| 字符 | 描述 | 模式 | 替换模式 | 输入字符串 | 结果字符串 |
|---|---|---|---|---|---|
| $number | 替换按组number一致した部分文字列。 | \b(\w+)(\s)(\w+)\b | $3$2$1 | "one two" | "two one" |
| ${name} | 名前付きグループによる置換name一致した部分文字列。 | \b(?< word1>\w+)(\s)(?< word2>\w+)\b | ${word2} ${word1} | "one two" | "two one" |
| $$ | 置換文字 "$" | \b(\d+)\s?USD | $$$1 | "103 USD" | "$103" |
| $& | マッチした項目全体のコピーを置換します。 | (\$*(\d*(\.+\d+)?){1}) | **$& | "$1.30" | "**$1.30" |
| $` | マッチする前の入力文字列のすべてのテキストを置換します。 | B+ | $` | "AABBCC" | "AAAACC" |
| $' | マッチした後の入力文字列のすべてのテキストを置換します。 | B+ | $' | "AABBCC" | "AACCCC" |
| $+ | 最後にキャプチャされたグループを置換します。 | B+(C+) | $+ | "AABBCCDD" | AACCDD |
| $_ | 入力文字列全体を置換します。 | B+ | $_ | "AABBCC" | "AAAABBCCCC" |
杂项构造
次の表は、さまざまなその他の構造の一覧です:
| 构造 | 描述 | 实例 |
|---|---|---|
| (?imnsx-imnsx) | パターン内で、大文字と小文字を区別しないなどのオプションを設定または無効にします。 | \bA(?i)b\w+\b は "ABA Able Act" 内の "ABA" と "Able" にマッチする |
| (?#注释) | インラインコメント。このコメントは最初の右括弧で終了します。 | \bA(?#Aで始まる単語に一致)\w+\b |
| # [行尾] | このコメントはエスケープされていない # で始まり、行の末尾まで続きます。 | (?x)\bA\w+\b# A で始まる単語と一致 |
Regex 类
Regex クラスは .NET で正規表現を使用するための中心的なクラスであり、System.Text.RegularExpressions名前空間の下にあります。使用する前に、ファイルの先頭に次のコードを追加する必要があります:
using System.Text.RegularExpressions;
以下の表は、Regex クラスでよく使用されるいくつかのメソッドを示しています:
| 序号 | メソッド & 説明 |
|---|---|
| 1 | public bool IsMatch(
string input
)
入力文字列が正規表現パターンに一致する内容を含むかどうかを判断します。フォーム検証(電話番号やメールアドレス形式の検証など)でよく使用されます。 |
| 2 | public bool IsMatch(
string input,
int startat
)
文字列の指定された開始位置からマッチング判定を行います。 |
| 3 | public static bool IsMatch(
string input,
string pattern
)
静的メソッドであり、Regexオブジェクトを事前に作成する必要はなく、パターン文字列を直接渡してマッチング判定を行います。一度だけ使用するシナリオに適しています。 |
| 4 | public MatchCollection Matches(
string input
)
入力文字列内のすべての一致項目を検索し、MatchCollection コレクションを返します。foreach を使用して各一致結果を反復処理できます。 |
| 5 | public string Replace(
string input,
string replacement
)
入力文字列内の正規表現パターンに一致するすべてのコンテンツを、指定された文字列に置換します。 |
| 6 | public string[] Split(
string input
)
正規表現パターンで定義された区切り文字に従って、入力文字列を部分文字列の配列に分割します。string.Split() よりも柔軟で、複雑な区切り規則をサポートします。 |
Regex クラスの完全なプロパティ一覧については、マイクロソフトの C# ドキュメントを参照してください。
实例 1
次の例は、'S' で始まる単語にマッチします:
解析:\b単語の境界であり、S大文字の S にマッチし、\S*ゼロ個以上の非空白文字に一致します。組み合わせると「S で始まる完全な単語」になります。
实例
using System.Text.RegularExpressions;
namespace RegExApplication
{
class Program
{
private static void showMatch(string text, string expr)
{
Console.WriteLine("The Expression: " + expr);
MatchCollection mc = Regex.Matches(text, expr);
foreach (Match m in mc)
{
Console.WriteLine(m);
}
}
static void Main(string[] args)
{
string str = "A Thousand Splendid Suns";
Console.WriteLine("Matching words that start with 'S': ");
showMatch(str, @"\bS\S*");
Console.ReadKey();
}
}
}
上記のコードがコンパイルおよび実行されると、次の結果が生成されます:
Matching words that start with 'S': The Expression: \bS\S* Splendid Suns
实例 2
次の例は、'm' で始まり 'e' で終わる単語にマッチします:
解析:\bmm で始まる単語にマッチし、\S*途中の任意の非空白文字にマッチし、e\be で終わり、その後に単語境界があることを要求します。合わせると、m で始まり e で終わるすべての単語を検索することになります。
实例
using System.Text.RegularExpressions;
namespace RegExApplication
{
class Program
{
private static void showMatch(string text, string expr)
{
Console.WriteLine("The Expression: " + expr);
MatchCollection mc = Regex.Matches(text, expr);
foreach (Match m in mc)
{
Console.WriteLine(m);
}
}
static void Main(string[] args)
{
string str = "make maze and manage to measure it";
Console.WriteLine("Matching words start with 'm' and ends with 'e':");
showMatch(str, @"\bm\S*e\b");
Console.ReadKey();
}
}
}
上記のコードがコンパイルおよび実行されると、次の結果が生成されます:
Matching words start with 'm' and ends with 'e': The Expression: \bm\S*e\b make maze manage measure
实例 3
次の例は余分なスペースを置換します:
解析:\\s+1つ以上の連続する空白文字(スペース、タブなど)に一致し、それらをすべて単一のスペースに置き換えることで、余分な空白をまとめます。
实例
using System.Text.RegularExpressions;
namespace RegExApplication
{
class Program
{
static void Main(string[] args)
{
string input = "Hello World ";
string pattern = "\\s+";
string replacement = " ";
Regex rgx = new Regex(pattern);
string result = rgx.Replace(input, replacement);
Console.WriteLine("Original String: {0}", input);
Console.WriteLine("Replacement String: {0}", result);
Console.ReadKey();
}
}
}
上記のコードがコンパイルおよび実行されると、次の結果が生成されます:
Original String: Hello World Replacement String: Hello World
GeneratedRegex: ソースジェネレーターの最適化(.NET 7+)
.NET 7 以降、C# は導入した...[GeneratedRegex]属性(ソースジェネレーター)は、従来のRegexクラスの重要なアップグレードであり、特に性能敏感或反复使用の正規表現シナリオ。
従来方式の問題
使用传统new Regex(pattern)場合、正規表現の解析とコンパイルは行われます运行时、毎回作成にはオーバーヘッドがあります。ただし、RegexOptions.Compiled実行速度は向上しますが、コンパイルは依然として実行時に行われ、起動時間とメモリ使用量が増加します。
传统方式
// 方式一:每次调用都重新解析(最慢)
bool isMatch = Regex.IsMatch(input, @"\d{4}-\d{2}-\d{2}");
// 方式二:静态字段 + Compiled(常见优化做法)
private static readonly Regex DateRegex = new Regex(@"\d{4}-\d{2}-\d{2}", RegexOptions.Compiled);
GeneratedRegex の用法
使用[GeneratedRegex]属性を使用すると、コンパイラは编译阶段正規表現を効率的な C# コードとして直接生成するため、実行時の解析やコンパイルが不要です。
使用条件: .NET 7 以降が必要で、かつそのメソッドはpartialメソッドであり、所属するクラスもpartial类。
GeneratedRegex 基本の使い方
using System.Text.RegularExpressions;
namespace RegExApplication
{
// クラスは partial として宣言する必要があります
partial class Program
{
// 使用 [GeneratedRegex] 特性,编译器自动生成实现
[GeneratedRegex(@"\d{4}-\d{2}-\d{2}")]
private static partial Regex DateRegex();
// 也可以附加选项,例如忽略大小写
[GeneratedRegex(@"\bS\S*", RegexOptions.IgnoreCase)]
private static partial Regex StartsWithSRegex();
static void Main(string[] args)
{
string input = "Today is 2024-06-18, next event: 2025-01-01";
// 普通のメソッドを呼び出すように使用し、Regex インスタンスを返します
foreach (Match m in DateRegex().Matches(input))
{
Console.WriteLine("找到日期:" + m.Value);
}
// 一致するか検証
Console.WriteLine(StartsWithSRegex().IsMatch("Splendid")); // True
}
}
}
上記のコードがコンパイルおよび実行されると、次の結果が生成されます:
找到日期:2024-06-18 找到日期:2025-01-01 True
GeneratedRegex と従来の Regex の比較
次の表は、複数の観点から2つの方法を比較し、適切な使用方法を選択するのに役立ちます:
| 比較次元 | 传统 Regex | GeneratedRegex(ソースジェネレーター) | 推荐 |
|---|---|---|---|
| 最低版本要求 | .NET Framework / .NET Core 全版本支持 | .NET 7 以降 | — |
| 编译时机 | ランタイム解析とコンパイル | コンパイル段階(ビルド時)に Roslyn ソースジェネレーターがコードを生成します。 | GeneratedRegex |
| 执行性能 | 普通:遅い。Compiled オプションを付けると:速いが、起動時のオーバーヘッドが大きい。 | 最速で、手書きコードのパフォーマンスに近く、起動時のオーバーヘッドもありません。 | GeneratedRegex |
| 内存占用 | Compiled モードは IL コードを生成するため、メモリ使用量が多くなります。 | 生成されるのは通常の C# コードで、メモリに優しいです。 | GeneratedRegex |
| AOT 兼容性 | RegexOptions.Compiled は AOT(事前コンパイル)と互換性がありません | Native AOT と完全に互換性があり、スタンドアロンアプリの発行に適しています。 | GeneratedRegex |
| 代码可读性 | パターン文字列がコードに直接書かれるため、比較的直感的です。 | partial メソッドを定義する必要があり、コード構造がやや複雑になります。 | 従来の Regex(単純なシナリオ) |
| 动态模式 | サポート、パターンは実行時の変数にできます | サポートされません。パターンはコンパイル時定数である必要があります。 | 従来の Regex(動的シナリオ) |
| 调试支持 | 普通 | 生成されたコードを直接確認およびデバッグでき、より透明です。 | GeneratedRegex |
| 适用场景 | 一度きりの使用、動的パターン、旧バージョンの .NET プロジェクト | 高頻度の呼び出し、パフォーマンス重視、AOT 発行、新しいバージョンの .NET プロジェクト | 视场景而定 |
使用建议
- 如果你使用.NET 7+かつ、正規表現パターンは固定されています。优先使用
[GeneratedRegex]。 - 正規表現パターンを実行時に動的に構築する必要がある場合(ユーザー入力に基づいて生成する場合など)は、従来の
new Regex(pattern)。 - プロジェクトがサポートを必要とする場合Native AOT発行(例: .NET 8 の AOT モード)する場合は、必ず使用してください。
[GeneratedRegex]而非RegexOptions.Compiled。 - 初心者には、まず従来の方法で学習と練習を行い、正規表現の原理を理解した後、実際のプロジェクトで徐々に移行
[GeneratedRegex]。
例: GeneratedRegex を使用してメールアドレスの形式を検証する
using System.Text.RegularExpressions;
partial class EmailValidator
{
// 定义邮箱验证正则,忽略大小写
[GeneratedRegex(@"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$", RegexOptions.IgnoreCase)]
private static partial Regex EmailRegex();
public static bool IsValidEmail(string email)
{
return EmailRegex().IsMatch(email);
}
static void Main(string[] args)
{
string[] emails = { "user@example.com", "bad-email", "hello@world.org", "missing@dot" };
foreach (var email in emails)
{
Console.WriteLine($"{email}: {(IsValidEmail(email) ? "有效" : "无效")}");
}
}
}
上記のコードがコンパイルおよび実行されると、次の結果が生成されます:
user@example.com: 有效 bad-email: 无效 hello@world.org: 有效 missing@dot: 无效其他扩展