Share via

Функция Replace (Visual Basic)

  • Статья

Обновлен: Ноябрь 2007

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

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

Параметры

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

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

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

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

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

  • Compare
    Необязательный параметр. Числовое значение, которое указывает вид сравнения, выполняемого при оценке подстрок. Возможные значения см. в разделе "Параметры".

Параметры

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

Константа

Описание

Binary

Выполняется двоичное сравнение.

Text

Выполняется текстовое сравнение.

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

Функция Replace возвращает следующие значения.

Если

Функция Replace возвращает

Find имеет нулевую длину или Nothing

Копия Expression

Replace имеет нулевую длину

Копия Expression без вхождений Find

Expression либо имеет нулевую длину, либо значение Nothing, или значение Start больше длины выражения Expression

Nothing

Count равно 0

Копия Expression

Исключения

Тип исключения

Номер ошибки

Условия

ArgumentException

5

Значение параметра Count < -1 или Start <= 0.

См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err).) Однако по возможности следует заменять такую обработку ошибок на Обзор структурной обработки исключений в Visual Basic.

Заметки

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

Пример

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

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

Требования

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

**Модуль:**Strings

**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

См. также

Ссылки

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

Функция Filter (Visual Basic)

ArgumentException