Resumo : neste tutorial, você aprenderá como usar o Join()
método string C# para concatenar uma coleção de elementos usando um separador especificado.
Introdução ao método C# String Join()
O método de string Join()
C# permite concatenar uma coleção de elementos em uma única string usando um separador especificado.
Aqui está a sintaxe do Join()
método String:
public static string Join<T> (
string? separator,
IEnumerable<T> values
);
Linguagem de código: C# ( cs )
Nesta sintaxe:
T
é o tipo dos membros dos valores.separator
é uma string usada como separador entre os elementos davalues
coleção.values
é uma coleção de elementos para concatenar. Pode ser qualquer coleção que implemente a interface IEnumerable<T> .
O Join()
método retorna uma única string que consiste em elementos de valores separados pela separator
string.
Se a coleção de valores não tiver elementos, o Join()
método retornará uma string vazia, ou seja String.Empty
.
Exemplos do método String Join() em C#
Vejamos alguns exemplos de uso do Join()
método.
1) Usando o método string Join() para concatenar um array de strings
O exemplo a seguir ilustra como usar o Join()
método para concatenar strings de um array usando uma vírgula como separador:
using static System.Console;
string[] fruits = {
"apple",
"banana",
"orange",
"mango",
};
var result = string.Join(",", fruits);
WriteLine(result);
Linguagem de código: C# ( cs )
Saída:
apple,banana,orange,mango
Linguagem de código: C# ( cs )
2) Usando o método string Join() com um espaço como separador
O exemplo a seguir ilustra como usar o Join()
método para concatenar uma lista de strings usando um espaço como separador:
using static System.Console;
var names = new List<string> { "John", "Jane", "Bob", "Alice" };
var result = string.Join(" ", names);
WriteLine(result);
Linguagem de código: C# ( cs )
Saída:
John Jane Bob Alice
Linguagem de código: C# ( cs )
3) Usando o método string Join() para concatenar um array de caracteres
O exemplo a seguir mostra como usar o Join()
método para concatenar uma matriz de caracteres em uma única string:
using static System.Console;
char[] characters = { 'H', 'e', 'l', 'l', 'o' };
var result = string.Join("", characters);
WriteLine(result);
Linguagem de código: C# ( cs )
Saída:
Hello
Linguagem de código: C# ( cs )
4) Usando o método string join() para concatenar um array de objetos
Se você passar um array de objetos para o Join()
método, ele usará a representação em string do objeto para concatenar. Por exemplo:
using static System.Console;
var members = new List<Person>() {
new Person("John", "Doe"),
new Person("Jane", "Doe")
};
var result = string.Join(",", members);
WriteLine(result);
public class Person
{
public string FirstName { get; set;}
public string LastName { get; set;}
public Person(string firstName, string lastName)
{
FirstName = firstName;
LastName = lastName;
}
public override string ToString() => $"{FirstName} {LastName}";
}
Linguagem de código: C# ( cs )
Saída:
John Doe,Jane Doe
Linguagem de código: C# ( cs )
Selecionando elementos para concatenar
A seguinte sobrecarga do Join()
método para concatenar elementos de uma coleção seletivamente:
public static string Join (
string? separator,
string?[] value,
int startIndex,
int count
);
Linguagem de código: C# ( cs )
Nesta sintaxe:
startIndex
é o primeiro elemento na coleção de valores a ser concatenado.count
especifica o número de elementos davalue
matriz a serem concatenados, começando com o elemento no arquivostartIndex
.
O Join()
método retorna uma única string que consiste em count
elementos da matriz de valores começando em startIndex
separados por separator
.
O exemplo a seguir ilustra como usar o Join()
método para concatenar dois elementos começando no segundo elemento da colors
matriz:
using static System.Console;
var colors = new string[] { "red", "green", "blue", "yellow" };
var result = string.Join(
separator: ",",
value: colors,
startIndex: 1,
count: 2
);
WriteLine(result);
Linguagem de código: C# ( cs )
Saída:
green,blue
Linguagem de código: C# ( cs )
Resumo
- Use o método de string C#
Join()
para concatenar os elementos de uma coleção em uma string usando um separador especificado.