Язык

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

Представляет неизменяемое регулярное выражение. Также содержит статические методы, которые позволяют использовать регулярные выражения без явного создания экземпляра Regex.

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
Производный
Атрибуты
SerializableAttribute
Реализации
ISerializable

Комментарии

Класс Regex представляет подсистему регулярных выражений .NET. Его можно использовать для быстрого анализа больших объемов текста для поиска определенных шаблонов символов; для извлечения, изменения, замены или удаления подстроок текста; и добавление извлеченных строк в коллекцию для создания отчета.

Конструкторы

Имя. Описание
Regex()

Инициализирует новый экземпляр класса Regex.
Regex(SerializationInfo, StreamingContext)
Устаревшие.

Инициализирует новый экземпляр Regex класса с помощью сериализованных данных.
Regex(String, RegexOptions, TimeSpan)

Инициализирует новый экземпляр класса для указанного Regex регулярного выражения с параметрами, которые изменяют шаблон и значение, указывающее, сколько времени метод сопоставления шаблонов должен попытаться выполнить совпадение до истечения времени ожидания.
Regex(String, RegexOptions)

Инициализирует новый экземпляр класса для указанного регулярного Regex выражения с параметрами, которые изменяют шаблон.
Regex(String)

Инициализирует новый экземпляр класса для указанного регулярного Regex выражения.

Поля

Имя. Описание
capnames

При использовании именованных записей сопоставляются имена записи с соответствующим индексом. В противном случае — null.
caps

При разрежении записи сопоставляет числа записи с соответствующим индексом в массиве записи. В противном случае — null.
capsize

Количество групп записи, определенных в шаблоне регулярных выражений.
capslist

При использовании разреженных или именованных записей записи содержит отсортированный список имен захвата. В противном случае — null.
factory

Фабрика, используемая для создания RegexRunner экземпляров для выполнения регулярного выражения.
InfiniteMatchTimeout

Указывает, что операция сопоставления шаблонов не должна истекать.
internalMatchTimeout

Максимальное время, которое может пройти в операции сопоставления шаблонов до истечения времени ожидания операции.
pattern

Шаблон регулярного выражения, переданный конструктору.
roptions

Параметры регулярного выражения, переданные конструктору.

Свойства

Имя. Описание
CacheSize

Возвращает или задает максимальное количество записей в текущем статическом кэше экземпляров регулярных выражений.
CapNames

Возвращает или задает словарь, который сопоставляет именованные группы записи с их значениями индекса.
Caps

Возвращает или задает словарь, который сопоставляет нумерованные группы записи со своими значениями индекса.
MatchTimeout

Возвращает интервал времени ожидания текущего экземпляра.
Options

Возвращает параметры, переданные Regex в конструктор.
RightToLeft

Возвращает значение, указывающее, выполняется ли поиск регулярных выражений справа налево.

Методы

Имя. Описание
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)

Выполняет поиск входного диапазона для всех вхождения регулярного выражения и возвращает Regex.ValueMatchEnumerator итерацию по совпадениям.
EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Выполняет поиск входного диапазона для всех вхождения регулярного выражения и возвращает Regex.ValueMatchEnumerator итерацию по совпадениям.
EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions)

Выполняет поиск входного диапазона для всех вхождения регулярного выражения и возвращает Regex.ValueMatchEnumerator итерацию по совпадениям.
EnumerateMatches(ReadOnlySpan<Char>, String)

Выполняет поиск входного диапазона для всех вхождения регулярного выражения и возвращает Regex.ValueMatchEnumerator итерацию по совпадениям.
EnumerateMatches(ReadOnlySpan<Char>)

Выполняет поиск входного диапазона для всех вхождения регулярного выражения и возвращает Regex.ValueMatchEnumerator итерацию по совпадениям.
EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)

Выполняет поиск диапазона входных данных для всех вхождения регулярного выражения и возвращает Regex.ValueSplitEnumerator итерацию по разбиениям вокруг совпадений.
EnumerateSplits(ReadOnlySpan<Char>, Int32)

Выполняет поиск диапазона входных данных для всех вхождения регулярного выражения и возвращает Regex.ValueSplitEnumerator итерацию по разбиениям вокруг совпадений.
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Выполняет поиск диапазона входных данных для всех вхождения регулярного выражения и возвращает Regex.ValueSplitEnumerator итерацию по разбиениям вокруг совпадений.
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)

Выполняет поиск диапазона входных данных для всех вхождения регулярного выражения и возвращает Regex.ValueSplitEnumerator итерацию по разбиениям вокруг совпадений.
EnumerateSplits(ReadOnlySpan<Char>, String)

Выполняет поиск диапазона входных данных для всех вхождения регулярного выражения и возвращает Regex.ValueSplitEnumerator итерацию по разбиениям вокруг совпадений.
EnumerateSplits(ReadOnlySpan<Char>)

Выполняет поиск диапазона входных данных для всех вхождения регулярного выражения и возвращает Regex.ValueSplitEnumerator итерацию по разбиениям вокруг совпадений.
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Escape(String)

Экранирует минимальный набор символов (*, +, ?, |, {, [, ^, ^, $, ., #, и пробел), заменив их кодами escape-кода. Это указывает обработчику регулярных выражений интерпретировать эти символы буквально, а не как метахарактеры.
Finalize()

Этот член переопределяет Finalize()и более полную документацию может быть доступна в этом разделе.

Object Позволяет пытаться освободить ресурсы и выполнять другие операции очистки перед Object восстановлением сборки мусора.
GetGroupNames()

Возвращает массив записей имен групп для регулярного выражения.
GetGroupNumbers()

Возвращает массив записей номеров групп, соответствующих именам групп в массиве.
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
GroupNameFromNumber(Int32)

Возвращает имя группы, соответствующее указанному номеру группы.
GroupNumberFromName(String)

Возвращает номер группы, соответствующий указанному имени группы.
InitializeReferences()
Устаревшие.

Используется объектом, Regex созданным методом CompileToAssembly(RegexCompilationInfo[], AssemblyName) . Этот метод устарел.
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()
Устаревшие.

Значение true, если Compiled параметр был задан.
UseOptionR()
Устаревшие.

Значение true, если RightToLeft параметр был задан.
ValidateMatchTimeout(TimeSpan)

Проверяет, является ли указанное значение времени ожидания совпадения допустимым. Допустимый диапазон .TimeSpan.Zero < matchTimeout <= Regex.MaximumMatchTimeout

Явные реализации интерфейса

Имя. Описание
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет SerializationInfo объект данными, необходимыми для десериализации текущего Regex объекта.

Применяется к

Потокобезопасность

Класс Regex является неизменяемым (только для чтения) и потокобезопасным. Regex Объекты можно создавать в любом потоке и совместно использовать между потоками. Дополнительные сведения см. в разделе "Безопасность потоков".

См. также