Junção de string C# – 01

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 da valuescoleçã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 separatorstring.

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,mangoLinguagem 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 AliceLinguagem 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:

HelloLinguagem 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 DoeLinguagem 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.
• countespecifica o número de elementos da valuematriz a serem concatenados, começando com o elemento no arquivo startIndex.

O Join()método retorna uma única string que consiste em countelementos da matriz de valores começando em startIndexseparados por separator.

O exemplo a seguir ilustra como usar o Join()método para concatenar dois elementos começando no segundo elemento da colorsmatriz:

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,blueLinguagem 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.