Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

String.Join — unir elementos com um separador

String.Join combina elementos numa única cadeia de caracteres, inserindo um separador entre eles. Os valores null não são ignorados.

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

Sintaxe

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

String.Join é um método estático de System.String; string.Join designa o mesmo método. Devolve o texto combinado, colocando o separador apenas entre os elementos.

No .NET 10, as sobrecargas suportam separadores string ou char, matrizes, IEnumerable<T> e spans ReadOnlySpan. As sobrecargas para objetos usam ToString(). A sobrecarga com startIndex e count seleciona um segmento de uma matriz.

Uma entrada vazia produz String.Empty. Um separador null equivale a texto vazio; o mesmo se aplica a um elemento null, mas a sua posição é mantida. Uma matriz ou coleção null causa ArgumentNullException; um intervalo inválido causa ArgumentOutOfRangeException.

Exemplos

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

Resultado

red||blue
|blue
[]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes