Функция Join (Visual Basic)
Обновлен: Ноябрь 2007
Возвращает строку, образуемую путем соединения нескольких подстрок, содержащихся в массиве.
Function Join(
ByVal SourceArray() As { Object | String },
Optional ByVal Delimiter As String = " "
) As String
Параметры
SourceArray
Обязательный. Одномерный массив подстрок, подлежащих объединению.Delimiter
Необязательный. Строка, используемая для разделения подстрок в составе возвращаемой строки. Если этот аргумент опущен, используется знак пробела (" "). Если в качестве Delimiter задана строка нулевой длины ("") или Nothing, все элементы списка объединяются без разделителей.
Исключения
Тип исключения |
Номер ошибки |
Условие |
|---|---|---|
SourceArray не является одномерным. |
См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err).) Однако, по возможности, следует заменять такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.
Заметки
Функции Join и Split являются сходными. Функция Join принимает массив строк и соединяет их, используя строку-разделитель для возвращения одной строки. Функция Split принимает строку и разделяет ее относительно разделителя для возвращения массива строк. Однако основным различием является то, что при помощи Join можно соединить строки с любой строкой-разделителем, а при помощи Split строки можно разделить с помощью односимвольного разделителя.
Пример
В следующем примере демонстрируется использование функции Join для создания списка из нескольких строк.
Dim TestItem() As String = {"Pickle", "Pineapple", "Papaya"}
' Returns "Pickle, Pineapple, Papaya"
Dim TestShoppingList As String = Join(TestItem, ", ")
Требования
Пространство имен:Microsoft.VisualBasic
**Модуль:**Strings
**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)