Regex.Replace Метод

Определение

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

System.Text.RegularExpressions

Сборки:

netstandard.dll, System.Text.RegularExpressions.dll

В указанной входной строке заменяет строки, которые соответствуют шаблону регулярного выражения заданной строкой замены.

Перегрузки

Имя	Описание
Replace(String, String, String, RegexOptions)	В указанной входной строке замените все строки, соответствующие указанному регулярному выражению, указанной строкой замены. Указанные параметры изменяют операцию сопоставления.
Replace(String, String, String, RegexOptions, TimeSpan)	В указанной входной строке замените все строки, соответствующие указанному регулярному выражению, указанной строкой замены. Дополнительные параметры указывают параметры, изменяющие операцию сопоставления и интервал времени ожидания, если совпадения не найдено.
Replace(String, MatchEvaluator, Int32, Int32)	В указанной подстроке ввода заменяет указанное максимальное количество строк, соответствующих шаблону регулярного выражения, строке, возвращаемой делегатом MatchEvaluator .
Replace(String, String, MatchEvaluator, RegexOptions)	В указанной входной строке заменяет все строки, соответствующие указанному регулярному выражению, строкой, возвращаемой делегатом MatchEvaluator . Указанные параметры изменяют операцию сопоставления.
Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)	В указанной входной строке заменяет все подстроки, соответствующие указанному регулярному выражению, строкой, возвращаемой делегатом MatchEvaluator . Дополнительные параметры указывают параметры, изменяющие операцию сопоставления и интервал времени ожидания, если совпадения не найдено.
Replace(String, String, Int32, Int32)	В указанной входной подстроке заменяет указанное максимальное количество строк, соответствующих шаблону регулярного выражения с указанной строкой замены.
Replace(String, String, String)	В указанной входной строке заменяются все строки, соответствующие указанному шаблону регулярного выражения с указанной строкой замены.
Replace(String, String, MatchEvaluator)	В указанной входной строке заменяет все строки, соответствующие указанному регулярному выражению, строкой, возвращаемой делегатом MatchEvaluator .
Replace(String, String, Int32)	В указанной входной строке заменяет указанное максимальное количество строк, которые соответствуют шаблону регулярного выражения заданной строкой замены.
Replace(String, MatchEvaluator)	В указанной входной строке заменяет все строки, соответствующие указанному регулярному выражению, строкой, возвращаемой делегатом MatchEvaluator .
Replace(String, String)	В указанной входной строке заменяются все строки, соответствующие шаблону регулярного выражения с указанной строкой замены.
Replace(String, MatchEvaluator, Int32)	В указанной входной строке заменяет указанное максимальное количество строк, соответствующих шаблону регулярного выражения, строке, возвращаемой делегатом MatchEvaluator .

Replace(String, String, String, RegexOptions)

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

Regex.Replace.cs

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

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options);

public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options);

static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions) As String

Параметры

input

String

Строка для поиска совпадения.

pattern

String

Шаблон регулярного выражения, соответствующий.

replacement

String

Строка, которой нужно заменить текст в исходной строке.

options

RegexOptions

Побитовое сочетание значений перечисления, которые предоставляют параметры сопоставления.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если pattern в текущем экземпляре не совпадает, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentException

Произошла ошибка синтаксического анализа регулярных выражений.

ArgumentNullException

input, или patternreplacement есть null.

ArgumentOutOfRangeException

options не является допустимым побитовой комбинацией значений RegexOptions .

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

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

Параметр replacement задает строку, которая заменяет каждое совпадение в input. replacement может состоять из любого сочетания литерального текста и подстановок. Замены — это единственные элементы языка регулярных выражений, которые распознаются в шаблоне замены.

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

RightToLeft Если задан параметрoptions, поиск совпадений начинается в конце входной строки и перемещается влево; в противном случае поиск начинается в начале входной строки и перемещается вправо.

Примечания для тех, кто вызывает этот метод

Этот метод истекает после интервала, равного значению времени ожидания по умолчанию домена приложения, в котором он вызывается. Если значение времени ожидания не определено для домена приложения, используется значение InfiniteMatchTimeout, которое предотвращает истечение времени ожидания метода. Рекомендуемый статический метод для замены совпадения шаблонов— Replace(String, String, String, RegexOptions, TimeSpan)это позволяет задать интервал времени ожидания.

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

• RegexOptions
• Подстановки в регулярных выражениях
• Элементы языка регулярных выражений

Replace(String, String, String, RegexOptions, TimeSpan)

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

Regex.Replace.cs

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

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions, matchTimeout As TimeSpan) As String

Параметры

input

String

Строка для поиска совпадения.

pattern

String

Шаблон регулярного выражения, соответствующий.

replacement

String

Строка, которой нужно заменить текст в исходной строке.

options

RegexOptions

Побитовое сочетание значений перечисления, которые предоставляют параметры сопоставления.

matchTimeout

TimeSpan

Интервал времени ожидания или InfiniteMatchTimeout указание, что метод не должен истекать.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если pattern в текущем экземпляре не совпадает, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentException

Произошла ошибка синтаксического анализа регулярных выражений.

ArgumentNullException

input, или patternreplacement есть null.

ArgumentOutOfRangeException

options не является допустимым побитовой комбинацией значений RegexOptions . -или- matchTimeout отрицательно, ноль или больше примерно 24 дней.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Статические Replace(String, String, String, RegexOptions, TimeSpan) методы эквивалентны созданию Regex объекта с указанным шаблоном регулярного выражения и вызовом метода Replace(String, String)экземпляра.

Параметр replacement задает строку, которая заменяет каждое совпадение в input. replacement может состоять из любого сочетания литерального текста и подстановок. Замены — это единственные элементы языка регулярных выражений, которые распознаются в шаблоне замены.

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

RightToLeft Если задан параметрoptions, поиск совпадений начинается в конце входной строки и перемещается влево; в противном случае поиск начинается в начале входной строки и перемещается вправо.

Параметр matchTimeout указывает, как долго метод сопоставления шаблонов должен попытаться найти совпадение до истечения времени ожидания. Установка интервала времени ожидания запрещает регулярным выражениям, которые полагаются на чрезмерную обратную дорожку, чтобы перестать отвечать на запросы при обработке входных данных, содержащих близкие совпадения. matchTimeout переопределяет любое значение времени ожидания по умолчанию, определенное для домена приложения, в котором выполняется метод.

Примечания для тех, кто вызывает этот метод

Рекомендуется задать matchTimeout для параметра соответствующее значение, например две секунды. Если вы отключаете время ожидания, указывая InfiniteMatchTimeout, подсистема регулярных выражений обеспечивает немного лучшую производительность. Однако вы должны отключить тайм-аут только в следующих условиях:

• Если входные данные, обработанные регулярным выражением, являются производными от известного и доверенного источника или состоят из статического текста. Это исключает текст, динамически введенный пользователями.

• При тщательном тестировании шаблона регулярного выражения для эффективной обработки совпадений, не совпадающих и близких совпадений.

• Если шаблон регулярного выражения не содержит языковых элементов, которые, как известно, вызывают чрезмерную обратную дорожку при обработке близкого совпадения.

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

• RegexOptions
• Подстановки в регулярных выражениях
• Элементы языка регулярных выражений
• Обратная дорожка в регулярных выражениях
• Рекомендации по регулярным выражениям в .NET

Replace(String, MatchEvaluator, Int32, Int32)

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

Regex.Replace.cs

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

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count, int startat);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count, int startat);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int * int -> string

Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer, startat As Integer) As String

Параметры

input

String

Строка для поиска совпадения.

evaluator

MatchEvaluator

Настраиваемый метод, который проверяет каждое совпадение и возвращает исходную соответствующую строку или строку замены.

count

Int32

Максимальное количество случаев замены.

startat

Int32

Позиция символа в входной строке, в которой начинается поиск.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если шаблон регулярного выражения не соответствует текущему экземпляру, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentNullException

input или evaluator есть null.

ArgumentOutOfRangeException

startat меньше нуля или больше длины input.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Дополнительные сведения см startat. в разделе Match(String, Int32)"Примечания".

Метод передает первые countMatch объекты делегату evaluator .

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

• MatchEvaluator
• Подстановки в регулярных выражениях
• Язык регулярных выражений — краткий справочник

Replace(String, String, MatchEvaluator, RegexOptions)

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

Regex.Replace.cs

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

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions) As String

Параметры

input

String

Строка для поиска совпадения.

pattern

String

Шаблон регулярного выражения, соответствующий.

evaluator

MatchEvaluator

Настраиваемый метод, который проверяет каждое совпадение и возвращает исходную соответствующую строку или строку замены.

options

RegexOptions

Побитовое сочетание значений перечисления, которые предоставляют параметры сопоставления.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если pattern в текущем экземпляре не совпадает, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentException

Произошла ошибка синтаксического анализа регулярных выражений.

ArgumentNullException

input, или patternevaluator есть null.

ArgumentOutOfRangeException

options не является допустимым побитовой комбинацией значений RegexOptions .

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Этот метод полезен для замены совпадения регулярного выражения, если одно из следующих условий имеет значение true: строка замены не может быть легко указана шаблоном замены регулярного выражения, результатом замены строки замены или строкой замены из условной обработки.

Метод эквивалентен вызову Matches(String, String) метода и передаче каждого Match объекта в возвращенном MatchCollection делегату evaluator .

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

RightToLeft Если задан параметрoptions, поиск совпадений начинается в конце входной строки и перемещается влево; в противном случае поиск начинается в начале входной строки и перемещается вправо.

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

• MatchEvaluator
• RegexOptions
• Подстановки в регулярных выражениях
• Элементы языка регулярных выражений

Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)

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

Regex.Replace.cs

В указанной входной строке заменяет все подстроки, соответствующие указанному регулярному выражению, строкой, возвращаемой делегатом MatchEvaluator . Дополнительные параметры указывают параметры, изменяющие операцию сопоставления и интервал времени ожидания, если совпадения не найдено.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions, matchTimeout As TimeSpan) As String

Параметры

input

String

Строка для поиска совпадения.

pattern

String

Шаблон регулярного выражения, соответствующий.

evaluator

MatchEvaluator

Настраиваемый метод, который проверяет каждое совпадение и возвращает исходную соответствующую строку или строку замены.

options

RegexOptions

Побитовое сочетание значений перечисления, которые предоставляют параметры сопоставления.

matchTimeout

TimeSpan

Интервал времени ожидания или InfiniteMatchTimeout указание, что метод не должен истекать.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если pattern в текущем экземпляре не совпадает, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentException

Произошла ошибка синтаксического анализа регулярных выражений.

ArgumentNullException

input, или patternevaluator есть null.

ArgumentOutOfRangeException

options не является допустимым побитовой комбинацией значений RegexOptions . -или- matchTimeout отрицательно, ноль или больше примерно 24 дней.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Этот метод полезен для замены совпадения регулярного выражения, если одно из следующих условий имеет значение true: строка замены не может быть легко указана шаблоном замены регулярного выражения, результатом замены строки замены или строкой замены из условной обработки.

Метод эквивалентен вызову Matches(String, String) метода и передаче каждого Match объекта в возвращенном MatchCollection делегату evaluator .

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

RightToLeft Если задан параметрoptions, поиск совпадений начинается в конце входной строки и перемещается влево; в противном случае поиск начинается в начале входной строки и перемещается вправо.

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

Примечания для тех, кто вызывает этот метод

Рекомендуется задать matchTimeout для параметра соответствующее значение, например две секунды. Если вы отключаете время ожидания, указывая InfiniteMatchTimeout, подсистема регулярных выражений обеспечивает немного лучшую производительность. Однако вы должны отключить тайм-аут только в следующих условиях:

• Если входные данные, обработанные регулярным выражением, являются производными от известного и доверенного источника или состоят из статического текста. Это исключает текст, динамически введенный пользователями.

• При тщательном тестировании шаблона регулярного выражения для эффективной обработки совпадений, не совпадающих и близких совпадений.

• Если шаблон регулярного выражения не содержит языковых элементов, которые, как известно, вызывают чрезмерную обратную дорожку при обработке близкого совпадения.

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

• RegexOptions
• Подстановки в регулярных выражениях
• Элементы языка регулярных выражений
• Обратная дорожка в регулярных выражениях
• Рекомендации по регулярным выражениям в .NET

Replace(String, String, Int32, Int32)

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

Regex.Replace.cs

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

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count, int startat);

public string Replace(string input, string replacement, int count, int startat);

member this.Replace : string * string * int * int -> string

Public Function Replace (input As String, replacement As String, count As Integer, startat As Integer) As String

Параметры

input

String

Строка для поиска совпадения.

replacement

String

Строка, которой нужно заменить текст в исходной строке.

count

Int32

Максимальное количество случаев, когда может произойти замена.

startat

Int32

Позиция символа в входной строке, в которой начинается поиск.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если шаблон регулярного выражения не соответствует текущему экземпляру, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentNullException

input или replacement есть null.

ArgumentOutOfRangeException

startat меньше нуля или больше длины input.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Дополнительные сведения см startat. в разделе Match(String, Int32)"Примечания".

Параметр replacement задает строку, которая заменяет каждое совпадение и поддерживает подстановки.

Если count это отрицательно, замена продолжается до конца строки.

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

• Подстановки в регулярных выражениях
• Язык регулярных выражений — краткий справочник

Replace(String, String, String)

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

Regex.Replace.cs

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

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement);

public static string Replace(string input, string pattern, string replacement);

static member Replace : string * string * string -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String) As String

Параметры

input

String

Строка для поиска совпадения.

pattern

String

Шаблон регулярного выражения, соответствующий.

replacement

String

Строка, которой нужно заменить текст в исходной строке.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если pattern в текущем экземпляре не совпадает, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentException

Произошла ошибка синтаксического анализа регулярных выражений.

ArgumentNullException

input, или patternreplacement есть null.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

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

Параметр replacement задает строку, которая заменяет каждое совпадение в input. replacement может состоять из любого сочетания литерального текста и подстановок. Замены — это единственные элементы языка регулярных выражений, которые распознаются в шаблоне замены.

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

Примечания для тех, кто вызывает этот метод

Этот метод истекает после интервала, равного значению времени ожидания по умолчанию домена приложения, в котором он вызывается. Если значение времени ожидания не определено для домена приложения, используется значение InfiniteMatchTimeout, которое предотвращает истечение времени ожидания метода. Рекомендуемый статический метод для замены совпадения шаблонов— Replace(String, String, String, RegexOptions, TimeSpan)это позволяет задать интервал времени ожидания.

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

• Подстановки в регулярных выражениях
• Элементы языка регулярных выражений

Replace(String, String, MatchEvaluator)

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

Regex.Replace.cs

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

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator) As String

Параметры

input

String

Строка для поиска совпадения.

pattern

String

Шаблон регулярного выражения, соответствующий.

evaluator

MatchEvaluator

Настраиваемый метод, который проверяет каждое совпадение и возвращает исходную соответствующую строку или строку замены.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если pattern в текущем экземпляре не совпадает, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentException

Произошла ошибка синтаксического анализа регулярных выражений.

ArgumentNullException

input, или patternevaluator есть null.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Этот метод полезен для замены совпадения регулярного выражения, если одно из следующих условий имеет значение true: строка замены не может быть легко указана шаблоном замены регулярного выражения, результатом замены строки замены или строкой замены из условной обработки.

Метод эквивалентен вызову Matches(String, String) метода и передаче каждого Match объекта в возвращенном MatchCollection делегату evaluator .

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

Примечания для тех, кто вызывает этот метод

Этот метод истекает после интервала, равного значению времени ожидания по умолчанию домена приложения, в котором он вызывается. Если значение времени ожидания не определено для домена приложения, используется значение InfiniteMatchTimeout, которое предотвращает истечение времени ожидания метода. Рекомендуемый статический метод для оценки и замены совпадения шаблонов— Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)это позволяет задать интервал времени ожидания.

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

• MatchEvaluator
• Подстановки в регулярных выражениях
• Элементы языка регулярных выражений

Replace(String, String, Int32)

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

Regex.Replace.cs

В указанной входной строке заменяет указанное максимальное количество строк, которые соответствуют шаблону регулярного выражения заданной строкой замены.

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count);

public string Replace(string input, string replacement, int count);

member this.Replace : string * string * int -> string

Public Function Replace (input As String, replacement As String, count As Integer) As String

Параметры

input

String

Строка для поиска совпадения.

replacement

String

Строка, которой нужно заменить текст в исходной строке.

count

Int32

Максимальное количество случаев, когда может произойти замена.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если шаблон регулярного выражения не соответствует текущему экземпляру, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentNullException

input или replacement есть null.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Поиск начинается в начале input строки. Параметр replacement задает строку, которая заменяет каждое совпадение и поддерживает подстановки.

Если count это отрицательно, замена продолжается до конца строки.

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

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

• Язык регулярных выражений — краткий справочник
• Подстановки в регулярных выражениях

Replace(String, MatchEvaluator)

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

Regex.Replace.cs

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

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator -> string

Public Function Replace (input As String, evaluator As MatchEvaluator) As String

Параметры

input

String

Строка для поиска совпадения.

evaluator

MatchEvaluator

Настраиваемый метод, который проверяет каждое совпадение и возвращает исходную соответствующую строку или строку замены.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если шаблон регулярного выражения не соответствует текущему экземпляру, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentNullException

input или evaluator есть null.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Этот метод полезен для замены совпадения регулярного выражения, если одно из следующих условий имеет значение true: строка замены не может быть легко указана шаблоном замены регулярного выражения, результатом замены строки замены или строкой замены из условной обработки.

Метод эквивалентен вызову Matches(String) метода и передаче каждого Match объекта в возвращенном MatchCollection делегату evaluator .

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

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

• MatchEvaluator
• Подстановки в регулярных выражениях
• Язык регулярных выражений — краткий справочник

Replace(String, String)

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

Regex.Replace.cs

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

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement);

public string Replace(string input, string replacement);

member this.Replace : string * string -> string

Public Function Replace (input As String, replacement As String) As String

Параметры

input

String

Строка для поиска совпадения.

replacement

String

Строка, которой нужно заменить текст в исходной строке.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если шаблон регулярного выражения не соответствует текущему экземпляру, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentNullException

input или replacement есть null.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Поиск шаблона начинается в начале input строки.

Параметр replacement задает строку, которая заменяет каждое совпадение. replacement может состоять из любого сочетания литерального текста и подстановок. Замены — это единственные элементы языка регулярных выражений, которые распознаются в шаблоне замены.

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

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

• Язык регулярных выражений — краткий справочник
• Подстановки в регулярных выражениях

Replace(String, MatchEvaluator, Int32)

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

Regex.Replace.cs

В указанной входной строке заменяет указанное максимальное количество строк, соответствующих шаблону регулярного выражения, строке, возвращаемой делегатом MatchEvaluator .

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int -> string

Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer) As String

Параметры

input

String

Строка для поиска совпадения.

evaluator

MatchEvaluator

Настраиваемый метод, который проверяет каждое совпадение и возвращает исходную соответствующую строку или строку замены.

count

Int32

Максимальное количество случаев замены.

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

String

Новая строка, идентичная входной строке, за исключением того, что строка замены занимает место каждой соответствующей строки. Если шаблон регулярного выражения не соответствует текущему экземпляру, метод возвращает текущий экземпляр без изменений.

Исключения

ArgumentNullException

input или evaluator есть null.

RegexMatchTimeoutException

Произошло время ожидания.

Комментарии

Этот метод полезен для замены совпадения регулярного выражения, если одно из следующих условий имеет значение true: строка замены не может быть легко указана шаблоном замены регулярного выражения, результатом замены строки замены или строкой замены из условной обработки.

Метод эквивалентен вызову Matches(String) метода и передаче первых countMatch объектов в возвращенном MatchCollection делегату evaluator .

Если count это отрицательно, замена продолжается до конца строки.

Так как метод возвращает input без изменений, если совпадения нет, можно использовать ReferenceEquals(Object, Object) метод для определения того, сделал ли метод какие-либо замены.

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

• MatchEvaluator
• Подстановки в регулярных выражениях
• Язык регулярных выражений — краткий справочник