Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

String.Join — réunir des éléments avec un séparateur

String.Join rassemble des éléments en une seule chaîne en insérant un séparateur entre eux. Les valeurs null ne sont pas ignorées.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

string.Join(separator, values)
string.Join(separator, value, startIndex, count)

String.Join est une méthode statique de System.String ; string.Join désigne la même méthode. Elle renvoie le texte assemblé en plaçant le séparateur uniquement entre les éléments.

Dans .NET 10, les surcharges prennent en charge les séparateurs de type string ou char, les tableaux, IEnumerable<T> et les plages ReadOnlySpan. Les surcharges pour les objets utilisent ToString(). La surcharge avec startIndex et count sélectionne une partie d’un tableau.

Une entrée vide produit String.Empty. Un séparateur null équivaut à un texte vide ; il en va de même pour un élément null, mais sa position est conservée. Un tableau ou une collection null provoque ArgumentNullException ; une plage invalide provoque ArgumentOutOfRangeException.

Exemples

using System;

string?[] values = { "red", null, "blue" };
Console.WriteLine(string.Join("|", values));
Console.WriteLine(string.Join("|", values, 1, 2));
Console.WriteLine($"[{string.Join("|", Array.Empty<string>())}]");

Résultat

red||blue
|blue
[]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources