Strings.Replace(String, String, String, Int32, Int32, CompareMethod) Метод

Определение

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

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

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

Strings.vb

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

public static string? Replace (string? Expression, string? Find, string? Replacement, int Start = 1, int Count = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Replace : string * string * string * int * int * Microsoft.VisualBasic.CompareMethod -> string

Public Function Replace (Expression As String, Find As String, Replacement As String, Optional Start As Integer = 1, Optional Count As Integer = -1, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String

Параметры

Expression

String

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

Find

String

Обязательный. Подстрока, которую требуется найти.

Replacement

String

Обязательный. Подстрока для замены.

Start

Int32

Необязательный элемент. Позиция в Expression, с которой начинается подстрока, используемая для замены. Возвращаемое значение Replace представляет собой строку, начинающуюся с Start с соответствующими заменами. Если этот аргумент не указан, используется значение 1.

Count

Int32

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

Compare

CompareMethod

Необязательный элемент. Числовое значение, показывающее вид сравнения, используемое при оценке подстрок. См. значения в разделе "Параметры".

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

String

Одно из следующих значений.

If	Функция Replace возвращает
Параметр Find является пустой строкой или значением Nothing	Копия выражения Expression
Параметр Replace имеет нулевую длину	Копия выражения Expression без вхождений строки Find
Строка Expression является пустой строкой или значением Nothing, или значение Start больше длины выражения Expression	Nothing
Count равно 0	Копия выражения Expression

Исключения

ArgumentException

Count< –1 или Start <= 0.

Примеры

В этом примере показана Replace функция .

Dim TestString As String = "Shopping List"  
' Returns "Shipping List".  
Dim aString As String = Replace(TestString, "o", "i")  

Комментарии

Возвращаемое значение Replace функции — это строка, которая начинается с позиции, указанной Expression параметром Start , и заканчивается в конце строки с подстановками, выполненными в соответствии со значениями Find и Replace .

Аргумент Compare может иметь следующие значения.

Константа	Описание
Binary	Выполняет двоичное сравнение
Text	Выполняет текстовое сравнение

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

• Filter
• ArgumentException
• Сводка по работе со строками