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

Определение

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

public static string? Replace (string? Expression, string? Find, string? Replacement, int Start = 1, int Count = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
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 больше длины выражения ExpressionNothing
Count равно 0 Копия выражения Expression

Исключения

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

Примеры

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

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

Комментарии

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

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

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

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

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