Regex 類別

定義

命名空間:: System.Text.RegularExpressions

組件:: System.dll, System.Text.RegularExpressions.dll

組件:: netstandard.dll, System.Text.RegularExpressions.dll

組件:: System.Text.RegularExpressions.dll

組件:: System.dll

組件:: netstandard.dll

來源:: Regex.cs

來源:: Regex.cs

來源:: Regex.cs

來源:: Regex.cs

來源:: Regex.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示不可變的正則表達式。

public ref class Regex

public ref class Regex : System::Runtime::Serialization::ISerializable

public class Regex

public class Regex : System.Runtime.Serialization.ISerializable

[System.Serializable]
public class Regex : System.Runtime.Serialization.ISerializable

type Regex = class

type Regex = class
    interface ISerializable

[<System.Serializable>]
type Regex = class
    interface ISerializable

Public Class Regex

Public Class Regex
Implements ISerializable

繼承: Object
Regex

衍生: System.Web.RegularExpressions.AspCodeRegex

System.Web.RegularExpressions.AspEncodedExprRegex

System.Web.RegularExpressions.AspExprRegex

System.Web.RegularExpressions.CommentRegex

System.Web.RegularExpressions.DatabindExprRegex

更多…

屬性: SerializableAttribute

實作: ISerializable

備註

欲了解更多關於此 API 的資訊，請參閱正則表達式的補充 API 備註。

這很重要

正則表達式引擎假設模式是被信任的。欲了解更多資訊，請參閱使用受信任模式。

建構函式

名稱	Description
Regex()	初始化 Regex 類別的新執行個體。
Regex(SerializationInfo, StreamingContext)	已淘汰. 透過序列化資料初始化該類別的新實例 Regex 。
Regex(String, RegexOptions, TimeSpan)	初始化該類別的新實例 Regex ，針對指定的正則表達式，並加入修改模式的選項，以及一個值，指定模式匹配方法應嘗試匹配多久後才會逾時。
Regex(String, RegexOptions)	初始化該類別的新實例 Regex ，並以修改模式的選項。
Regex(String)	初始化該類別的新實例 Regex ，以初始化指定的正規表達式。

欄位

名稱	Description
capnames	由 Regex 方法 CompileToAssembly 產生的物件所使用。
caps	由 Regex 方法 CompileToAssembly 產生的物件所使用。
capsize	由 Regex 方法 CompileToAssembly 產生的物件所使用。
capslist	由 Regex 方法 CompileToAssembly 產生的物件所使用。
factory	由 Regex 方法 CompileToAssembly 產生的物件所使用。
InfiniteMatchTimeout	指定模式比對作業不應逾時。
internalMatchTimeout	作業逾時之前，模式比對作業中可以經過的時間上限。
pattern	由 Regex 方法 CompileToAssembly 產生的物件所使用。
roptions	由 Regex 方法 CompileToAssembly 產生的物件所使用。

屬性

名稱	Description
CacheSize	取得或設定編譯正則表達式目前靜態快取中的項目數目上限。
CapNames	取得或設定將具名擷取群組對應至其索引值的字典。
Caps	取得或設定將編號擷取群組對應至其索引值的字典。
MatchTimeout	取得目前實例的超時時間間隔。
Options	取得傳入 Regex 建造者的選項。
RightToLeft	取得值，這個值表示正則表達式是否從右至左搜尋。

方法

名稱	Description
CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[], String)	已淘汰. 將一個或多個指定的 Regex 物件及指定的資源檔案編譯成具指定屬性的命名組合語言。
CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[])	已淘汰. 將一個或多個指定的 Regex 物件編譯為具有指定屬性的命名組裝。
CompileToAssembly(RegexCompilationInfo[], AssemblyName)	已淘汰. 將一個或多個指定的 Regex 物件編譯為命名的組裝。
Count(ReadOnlySpan<Char>, Int32)	搜尋輸入範圍中所有出現的正則表達式，並傳回相符項目的數目。
Count(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	搜尋輸入範圍中所有出現的正則表達式，並傳回相符項目的數目。
Count(ReadOnlySpan<Char>, String, RegexOptions)	搜尋輸入範圍中所有出現的正則表達式，並傳回相符項目的數目。
Count(ReadOnlySpan<Char>, String)	搜尋輸入範圍中所有出現的正則表達式，並傳回相符項目的數目。
Count(ReadOnlySpan<Char>)	搜尋輸入範圍中所有出現的正則表達式，並傳回相符項目的數目。
Count(String, String, RegexOptions, TimeSpan)	搜尋輸入字串中所有出現的正則表示式，並傳回相符項目的數目。
Count(String, String, RegexOptions)	搜尋輸入字串中所有出現的正則表示式，並傳回相符項目的數目。
Count(String, String)	搜尋輸入字串中所有出現的正則表示式，並傳回相符項目的數目。
Count(String)	搜尋輸入字串中所有出現的正則表示式，並傳回相符項目的數目。
EnumerateMatches(ReadOnlySpan<Char>, Int32)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueMatchEnumerator 以遍歷匹配。
EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueMatchEnumerator 以遍歷匹配。
EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueMatchEnumerator 以遍歷匹配。
EnumerateMatches(ReadOnlySpan<Char>, String)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueMatchEnumerator 以遍歷匹配。
EnumerateMatches(ReadOnlySpan<Char>)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueMatchEnumerator 以遍歷匹配。
EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, Int32)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, String)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Escape(String)	以逸出代碼取代字元集，以逸出最少的字元集（\、*、+、?、\|、{、[、^、$、.、#和空格符）。這會指示正則表達式引擎以字面方式解譯這些字元，而不是中繼字元。
Finalize()	此成員會 Finalize()覆蓋，相關主題中可能有更完整的文件可供參考。允許嘗試 Object 釋放資源並執行其他清理作業，直到被 Object 垃圾回收回收。
GetGroupNames()	傳回擷取正則表達式組名的陣列。
GetGroupNumbers()	傳回擷取群組編號的陣列，其對應至陣列中的組名。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GroupNameFromNumber(Int32)	取得對應至指定組號的組名。
GroupNumberFromName(String)	傳回對應至指定組名的組號。
InitializeReferences()	已淘汰. 由 Regex 方法 CompileToAssembly 產生的物件所使用。
IsMatch(ReadOnlySpan<Char>, Int32)	指出 Regex 建構函式中指定的正規表示式是否在指定的輸入範圍中尋找相符專案。
IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	指出指定的正則表示式是否使用指定的比對選項和超時時間間隔，在指定的輸入範圍中尋找相符專案。
IsMatch(ReadOnlySpan<Char>, String, RegexOptions)	指出指定的正則表示式是否使用指定的比對選項，在指定的輸入範圍中尋找相符專案。
IsMatch(ReadOnlySpan<Char>, String)	指出指定的正則表示式是否在指定的輸入範圍中尋找相符專案。
IsMatch(ReadOnlySpan<Char>)	指出 Regex 建構函式中指定的正規表示式是否在指定的輸入範圍中尋找相符專案。
IsMatch(String, Int32)	表示建構子中指定的 Regex 正則表達式是否在指定的輸入字串中找到匹配，且從該字串的指定起始位置開始。
IsMatch(String, String, RegexOptions, TimeSpan)	指出指定的正則表示式是否使用指定的比對選項和超時時間間隔，在指定的輸入字串中尋找相符專案。
IsMatch(String, String, RegexOptions)	指出指定的正則表示式是否使用指定的比對選項，在指定的輸入字元串中尋找相符專案。
IsMatch(String, String)	指出指定的正則表示式是否在指定的輸入字串中尋找相符專案。
IsMatch(String)	表示建構子中指定的 Regex 正則表達式是否在指定輸入字串中找到匹配。
Match(String, Int32, Int32)	搜尋輸入字串中第一次出現的正則表示式，從指定的起始位置開始，並只搜尋指定的字元數。
Match(String, Int32)	搜尋輸入字串中第一次出現的正則表示式，從字串中指定的起始位置開始。
Match(String, String, RegexOptions, TimeSpan)	使用指定的比對選項和超時時間間隔，搜尋輸入字串中第一個出現的指定正則表達式。
Match(String, String, RegexOptions)	使用指定的比對選項，搜尋輸入字串中第一個出現的指定正則表達式。
Match(String, String)	搜尋指定的輸入字串中第一個出現的指定正則表達式。
Match(String)	搜尋指定的輸入字串，尋找建構子中指定的 Regex 正則表達式的首次出現。
Matches(String, Int32)	搜尋指定的輸入字串中所有出現的正則表示式，從字串中指定的起始位置開始。
Matches(String, String, RegexOptions, TimeSpan)	使用指定的比對選項和超時時間間隔，搜尋指定之正則表示式的所有出現次數。
Matches(String, String, RegexOptions)	使用指定的比對選項，搜尋指定之正則表示式的所有出現次數的指定輸入字串。
Matches(String, String)	搜尋指定的輸入字串，以尋找指定正規表示式的所有專案。
Matches(String)	搜尋指定的輸入字串中是否有正則表示式的所有出現次數。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
Replace(String, MatchEvaluator, Int32, Int32)	在指定的輸入子字串中，會將符合正則表達式模式的最大字串數量替換為代理回傳 MatchEvaluator 的字串。
Replace(String, MatchEvaluator, Int32)	在指定的輸入字串中，會將與正則表達式模式匹配的字串數量，替換為代理回傳 MatchEvaluator 的字串。
Replace(String, MatchEvaluator)	在指定的輸入字串中，會將所有符合指定正則表達式的字串替換為代理回傳 MatchEvaluator 的字串。
Replace(String, String, Int32, Int32)	在指定的輸入子字串中，以指定的取代字串取代符合正則表示式模式的指定最大字串數目。
Replace(String, String, Int32)	在指定的輸入字串中，以指定的取代字串取代符合正則表示式模式的指定最大字串數目。
Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)	在指定的輸入字串中，會將所有符合指定正則表達式的子字串替換為代理回傳 MatchEvaluator 的字串。其他參數會指定修改比對作業的選項，如果找不到相符專案，則會指定超時時間間隔。
Replace(String, String, MatchEvaluator, RegexOptions)	在指定的輸入字串中，會將所有符合指定正則表達式的字串替換為代理回傳 MatchEvaluator 的字串。指定的選項會修改比對作業。
Replace(String, String, MatchEvaluator)	在指定的輸入字串中，會將所有符合指定正則表達式的字串替換為代理回傳 MatchEvaluator 的字串。
Replace(String, String, String, RegexOptions, TimeSpan)	在指定的輸入字串中，以指定的取代字串取代符合指定正規表示式的所有字串。其他參數會指定修改比對作業的選項，如果找不到相符專案，則會指定超時時間間隔。
Replace(String, String, String, RegexOptions)	在指定的輸入字串中，以指定的取代字串取代符合指定正規表示式的所有字串。指定的選項會修改比對作業。
Replace(String, String, String)	在指定的輸入字串中，以指定的取代字串取代符合指定正規表示式的所有字串。
Replace(String, String)	在指定的輸入字串中，以指定的取代字串取代符合正則表示式模式的所有字串。
Split(String, Int32, Int32)	將輸入字串以指定次數分拆成子串陣列，位置由建構子指定 Regex 的正則表達式定義。正則表達式模式的搜尋會從輸入字串中的指定字元位置開始。
Split(String, Int32)	將輸入字串以指定次數分拆成子串陣列，位置由建構子指定 Regex 的正則表達式定義。
Split(String, String, RegexOptions, TimeSpan)	將輸入字串分割成指定正則表示式模式所定義位置的子字串陣列。其他參數會指定修改比對作業的選項，如果找不到相符專案，則會指定超時時間間隔。
Split(String, String, RegexOptions)	將輸入字串分割成指定正則表示式模式所定義位置的子字串陣列。指定的選項會修改比對作業。
Split(String, String)	將輸入字串分割成正則表示式模式所定義位置的子字串陣列。
Split(String)	將輸入字串拆分為由建構子指定 Regex 正則表達式模式定義的位置的子串陣列。
ToString()	回傳傳入 `Regex` 建構子的正則表達式模式。
Unescape(String)	轉換輸入字串中的任何逸出字元。
UseOptionC()	已淘汰. 由 Regex 方法 CompileToAssembly 產生的物件所使用。
UseOptionR()	已淘汰. 由 Regex 方法 CompileToAssembly 產生的物件所使用。
ValidateMatchTimeout(TimeSpan)	檢查超時間隔是否在可接受的範圍內。

明確介面實作

名稱	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	將 SerializationInfo 物件填充以反序列化當前 Regex 物件所需的資料。

適用於

執行緒安全性

這個 Regex 類別是不可變的（唯讀）且執行緒安全。 Regex 物件可以在任何執行緒上建立，並在執行緒間共享。更多資訊請參見討論串安全。

另請參閱

意見反應

此頁面對您有幫助嗎？