Join (Función, Visual Basic)
Actualización: noviembre 2007
Devuelve una cadena creada a partir de la combinación de varias subcadenas contenidas en una matriz.
Function Join(
ByVal SourceArray() As { Object | String },
Optional ByVal Delimiter As String = " "
) As String
Parámetros
SourceArray
Obligatorio. Matriz unidimensional que contiene las subcadenas que se van a combinar.Delimiter
Opcional. Cualquier cadena utilizada para separar las subcadenas de la cadena devuelta. Si se omite, se utilizará el carácter de espacio (" "). Si Delimiter es una cadena de longitud cero ("") o Nothing, todos los elementos de la lista se concatenarán sin delimitadores.
Excepciones
Tipo de excepción |
Número de error |
Condición |
|---|---|---|
SourceArray no es unidimensional. |
Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.
Comentarios
Existe una paridad entre las funciones Join y Split. La función Join toma una matriz de cadenas y las une utilizando una cadena de delimitación para devolver una cadena única. La función Split toma una cadena y la separa en el delimitador para devolver una matriz de cadenas. Sin embargo, una diferencia fundamental es que Join puede concatenar cadenas con cualquier cadena de delimitación, Split puede separar sólo cadenas mediante un delimitador de carácter único.
Ejemplo
El ejemplo siguiente muestra cómo se utiliza la función Join para crear una lista a partir de varias cadenas.
Dim TestItem() As String = {"Pickle", "Pineapple", "Papaya"}
' Returns "Pickle, Pineapple, Papaya"
Dim TestShoppingList As String = Join(TestItem, ", ")
Requisitos
Espacio de nombres:Microsoft.VisualBasic
**Módulo:**Strings
**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)