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);static member Replace : string * string * string * int * int * Microsoft.VisualBasic.CompareMethod -> stringPublic 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
Optional. Позиция внутри этой Expression подстроки, используемой для замены. Возвращаемое значение Replace — это строка, которая начинается Startс соответствующих подстановок. Если этот аргумент не задан, используется значение 1.
- Count
- Int32
Optional. Число замен части строки. Если опущено, значение по умолчанию равно -1, то есть "сделать все возможные замены".
- Compare
- CompareMethod
Optional. Представляет собой числовое значение, указывающее вид сравнения, которое выполняется при оценке подстрок. См. раздел "Параметры" для значений.
Возвращаемое значение
Одно из следующих значений.
| Если | Функция "Replace" возвращает |
|---|---|
Find равно нулю или Nothing | Копия Expression |
Replace имеет нулевую длину |
Expression Копия без вхожденияFind |
Expressionравно нулю или больше длины NothingStart или больше длиныExpression | Nothing |
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 может иметь следующие значения.
| Константа | Description |
|---|---|
Binary |
Выполняет двоичное сравнение |
Text |
Выполняет текстовое сравнение |