Strings.Join, méthode (Object , String)

Article
08/21/2007

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

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function Join ( _
    SourceArray As Object(), _
    <OptionalAttribute> Optional Delimiter As String = " " _
) As String
'Utilisation
Dim SourceArray As Object()
Dim Delimiter As String
Dim returnValue As String

returnValue = Strings.Join(SourceArray, Delimiter)

public static string Join (
    Object[] SourceArray,
    [OptionalAttribute] string Delimiter
)

public:
static String^ Join (
    array<Object^>^ SourceArray, 
    [OptionalAttribute] String^ Delimiter
)

public static String Join (
    Object[] SourceArray, 
    /** @attribute OptionalAttribute() */ String Delimiter
)

public static function Join (
    SourceArray : Object[], 
    Delimiter : String
) : String

Paramètres

SourceArray
Obligatoire. Tableau unidimensionnel contenant les sous-chaînes qui doivent faire l'objet d'une jointure.

Delimiter
Facultatif. Chaîne quelconque, utilisée pour séparer les sous-chaînes dans la chaîne retournée. Si ce paramètre est omis, le caractère espace (" ") est utilisé. Si Delimiter est une chaîne de longueur nulle ("") ou a la valeur Nothing, tous les éléments de la liste sont concaténés sans délimiteurs.

Valeur de retour

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

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Join, fonction (Visual Basic).

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 ne retourner qu'une seule chaîne. La fonction Split prend une chaîne et la sépare au niveau du délimiteur, pour retourner un tableau de chaînes. Il existe toutefois une différence essentielle : Join peut concaténer des chaînes avec n'importe quelle chaîne de délimiteur, alors que Split ne peut séparer des chaînes qu'avec un délimiteur à un seul caractère.

Exemple

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

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

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Strings, classe
Membres Strings
Microsoft.VisualBasic, espace de noms
ArgumentException

Autres ressources

Join, fonction (Visual Basic)
Liste des manipulations de chaînes
Split, fonction (Visual Basic)

Partager via