Função Join (Visual Basic)
Retorna uma string criada juntando um certo número de substrings contidas em um array.
Function Join(
ByVal SourceArray() As { Object | String },
Optional ByVal Delimiter As String = " "
) As String
Parâmetros
SourceArray
Obrigatório.Array unidimensional contendo substrings deve ser unida.Delimiter
Opcional.Qualquer string, usada para separar as substrings na string retornada.Se omitido, o caractere de espaço (" ") é usado.Se Delimiter é uma string de comprimento nulo (" ") ou Nothing, todos os itens na lista são concatenados sem delimitadores.
Exceções
Tipo de exceção |
Número de erro |
Condição |
|---|---|---|
SourceArray não é uni-dimensional. |
Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.
Comentários
Há uma paridade entre as funções Join e Split.A função Join recebe um array de strings e as associa usando uma string delimitadora para retornar uma única string.A função Split recebe uma string e a separa no delimitador, para retornar um array de strings.No entanto, uma diferença chave é que Join pode concatenar strings com qualquer string delimitadora, Split somente pode separar strings usando um único caractere delimitador.
Exemplo
O exemplo a seguir demonstra como usar a função Join para criar uma lista de várias strings.
Dim TestItem() As String = {"Pickle", "Pineapple", "Papaya"}
' Returns "Pickle, Pineapple, Papaya"
Dim TestShoppingList As String = Join(TestItem, ", ")
Requisitos
Namespace:Microsoft.VisualBasic
**Módulo:**Strings
Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)