Regex.Escape(String) Метод

Определение

Пространство имен:

System.Text.RegularExpressions

Сборки:

netstandard.dll, System.Text.RegularExpressions.dll

Исходный код:

Regex.cs

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

public:
 static System::String ^ Escape(System::String ^ str);

public static string Escape(string str);

static member Escape : string -> string

Public Shared Function Escape (str As String) As String

Параметры

str

String

Входная строка, содержащая текст для преобразования.

Возвращаемое значение

String

Строка символов с метахарактерами, преобразованными в их escape-форму.

Исключения

ArgumentNullException

str равно null.

Комментарии

Escape(String) преобразует строку таким образом, чтобы обработчик регулярных выражений интерпретировал любые метачарактеры, которые могут содержаться как символьные литералы. Особенно важно для строк, которые определяются динамически с помощью символов, не известных во время разработки.

Хотя этот метод экранирует прямую открывающую скобку ([) и открывающую скобку ({), он не экранирует соответствующие закрывающие символы (] и }). В большинстве случаев экранирование этих не требуется.

См. также раздел

• Unescape(String)
• Язык регулярных выражений — краткий справочник
• Экранирование символов в регулярных выражениях