Join, fonction (Visual Basic)

Article
09/12/2008

Mise à jour : novembre 2007

Retourne une chaîne créée par la jonction de plusieurs sous-chaînes contenues dans un tableau.

Function Join(
   ByVal SourceArray() As { Object | String },
   Optional ByVal Delimiter As String = " "
) As String

Paramètres

SourceArray
Requis. Tableau à une dimension contenant les sous-chaînes à joindre.
Delimiter
Facultatif. Toute chaîne, utilisée pour séparer les sous-chaînes dans la chaîne retournée. Si cet argument est omis, le caractère espace (" ") est employé. Si Delimiter est une chaîne de longueur nulle ("") ou Nothing, tous les éléments de la liste sont concaténés sans délimiteur.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	SourceArray n'est pas unidimensionnel.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Une parité existe entre les fonctions Join et Split. La fonction Join prend un tableau de chaînes et les joint à l'aide d'une chaîne de délimiteur, pour retourner une chaîne unique. La fonction Split prend une chaîne et la sépare au niveau du délimiteur, pour retourner un tableau de chaînes. Toutefois, une différence essentielle est que Join peut concaténer des chaînes avec toute chaîne de délimiteur, alors que Split peut uniquement séparer des chaînes à l'aide d'un délimiteur de caractère unique.

Exemple

L'exemple suivant montre comment utiliser la fonction Join pour créer une liste à partir de plusieurs chaînes.

Dim TestItem() As String = {"Pickle", "Pineapple", "Papaya"}
' Returns "Pickle, Pineapple, Papaya"
Dim TestShoppingList As String = Join(TestItem, ", ")