Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

String.Join — łączenie elementów separatorem

String.Join łączy elementy w jeden string, wstawiając separator między nimi. Wartości null nie są pomijane.

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

Składnia

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

String.Join to statyczna metoda System.String; zapis string.Join oznacza tę samą metodę. Zwraca połączony tekst, umieszczając separator tylko między elementami.

W .NET 10 przeciążenia obsługują separator string lub char, tablice, IEnumerable<T> i zakresy ReadOnlySpan. Przeciążenia dla obiektów korzystają z ToString(). Wariant z startIndex i count wybiera fragment tablicy.

Puste dane dają String.Empty. Separator null oznacza pusty tekst; element null również, ale jego pozycja pozostaje. Tablica lub kolekcja będąca null powoduje ArgumentNullException; nieprawidłowy zakres powoduje ArgumentOutOfRangeException.

Przykłady

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>())}]");

Wynik

red||blue
|blue
[]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła