String.Join Метод

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join (string separator, params string[] value);

public static string Join (string? separator, params string?[] value);

public static string Join (string separator, string[] value);

Параметры

Возвращаемое значение

Строка, состоящая из элементов в value, разделенных строкой separator.

-или-

Empty, если value имеет нулевые элементы.

Исключения

Примеры

В следующем примере показан метод Join.

using System;

public class JoinTest
{
    public static void Main()
    {
        Console.WriteLine(MakeLine(0, 5, ", "));
        Console.WriteLine(MakeLine(1, 6, "  "));
        Console.WriteLine(MakeLine(9, 9, ": "));
        Console.WriteLine(MakeLine(4, 7, "< "));
    }

    private static string MakeLine(int initVal, int multVal, string sep)
    {
        string [] sArr = new string [10];

        for (int i = initVal; i < initVal + 10; i++)
            sArr[i - initVal] = String.Format("{0,-3}", i * multVal);

        return String.Join(sep, sArr);
    }
}
// The example displays the following output:
//       0  , 5  , 10 , 15 , 20 , 25 , 30 , 35 , 40 , 45
//       6    12   18   24   30   36   42   48   54   60
//       81 : 90 : 99 : 108: 117: 126: 135: 144: 153: 162
//       28 < 35 < 42 < 49 < 56 < 63 < 70 < 77 < 84 < 91

Комментарии

Например, если separator ", а элементы value — "яблоко", "оранжевый", "виноград" и "груша", Join(separator, value) возвращает "яблоко, апельсин, виноград, грушу".

Если separatornull, вместо этого используется пустая строка (String.Empty). Если любой элемент в valuenull, вместо этого используется пустая строка.

См. также раздел

• Concat(Object)

public static string Join (string? separator, scoped ReadOnlySpan<string?> value);

Параметры

Возвращаемое значение

Строка, состоящая из элементов value, разделенных строкой separator. -или- Empty, если value имеет нулевые элементы.

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join (string separator, string[] value, int startIndex, int count);

public static string Join (string? separator, string?[] value, int startIndex, int count);

Параметры

Возвращаемое значение

Строка, состоящая из элементов countvalue начиная с startIndex, разделенных символом separator.

-или-

Empty, если count равно нулю.

Исключения

Примеры

В следующем примере сцепляется два элемента из массива имен фруктов.

String[] val = {"apple", "orange", "grape", "pear"};
String sep   = ", ";
String result;

Console.WriteLine("sep = '{0}'", sep);
Console.WriteLine("val[] = {{'{0}' '{1}' '{2}' '{3}'}}", val[0], val[1], val[2], val[3]);
result = String.Join(sep, val, 1, 2);
Console.WriteLine("String.Join(sep, val, 1, 2) = '{0}'", result);

// This example produces the following results:
// sep = ', '
// val[] = {'apple' 'orange' 'grape' 'pear'}
// String.Join(sep, val, 1, 2) = 'orange, grape'

Комментарии

Например, если separator " и элементы value являются "яблоком", "оранжевым", "виноградом" и "грушей", Join(separator, value, 1, 2) возвращает "оранжевый, виноград".

Если separatornull, вместо этого используется пустая строка (String.Empty). Если любой элемент в valuenull, вместо этого используется пустая строка.

См. также раздел

• Split(Char[])

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join (char separator, string?[] value, int startIndex, int count);

public static string Join (char separator, string[] value, int startIndex, int count);

Параметры

Возвращаемое значение

Строка, состоящая из элементов countvalue начиная с startIndex, разделенных символом separator.

-или-

Empty, если count равно нулю.

Исключения

public static string Join (string? separator, scoped ReadOnlySpan<object?> values);

Параметры

Возвращаемое значение

Строка, состоящая из элементов values, разделенных строкой separator. -или- Empty, если values имеет нулевые элементы.

public static string Join (char separator, scoped ReadOnlySpan<object?> values);

Параметры

Возвращаемое значение

Строка, состоящая из элементов values, разделенных символом separator. -или- Empty, если values имеет нулевые элементы.

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join (string separator, System.Collections.Generic.IEnumerable<string> values);

public static string Join (string? separator, System.Collections.Generic.IEnumerable<string?> values);

[System.Runtime.InteropServices.ComVisible(false)]
public static string Join (string separator, System.Collections.Generic.IEnumerable<string> values);

Параметры

Возвращаемое значение

Строка, состоящая из элементов values, разделенных строкой separator.

-или-

Empty, если values имеет нулевые элементы.

Атрибуты

ComVisibleAttribute

Исключения

Примеры

В следующем примере используется алгоритм Sieve eratosthenes для вычисления простых чисел, которые меньше или равны 100. Он назначает результат объекту List<T> типа String, который затем передается в метод Join(String, IEnumerable<String>).

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main()
   {
      int maxPrime = 100;
      List<int> primes = GetPrimes(maxPrime);
      Console.WriteLine("Primes less than {0}:", maxPrime);
      Console.WriteLine("   {0}", String.Join(" ", primes));
   }

   private static List<int> GetPrimes(int maxPrime)
   {
      Array values = Array.CreateInstance(typeof(int), 
                              new int[] { maxPrime - 1}, new int[] { 2 });
      // Use Sieve of Eratosthenes to determine prime numbers.
      for (int ctr = values.GetLowerBound(0); ctr <= (int) Math.Ceiling(Math.Sqrt(values.GetUpperBound(0))); ctr++)
      {
                           
         if ((int) values.GetValue(ctr) == 1) continue;
         
         for (int multiplier = ctr; multiplier <=  maxPrime / 2; multiplier++)
            if (ctr * multiplier <= maxPrime)
               values.SetValue(1, ctr * multiplier);
      }      
      
      List<int> primes = new List<int>();
      for (int ctr = values.GetLowerBound(0); ctr <= values.GetUpperBound(0); ctr++)
         if ((int) values.GetValue(ctr) == 0) 
            primes.Add(ctr);
      return primes;
   }   
}
// The example displays the following output:
//    Primes less than 100:
//       2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97

Комментарии

Если separatornull, вместо этого используется пустая строка (String.Empty). Если любой элемент valuesnull, вместо этого используется пустая строка.

Join(String, IEnumerable<String>) — это удобный метод, позволяющий объединять каждый элемент в коллекции IEnumerable(Of String) без первого преобразования элементов в строковый массив. Это особенно полезно для выражений запросов Language-Integrated (LINQ). В следующем примере передается объект List(Of String), содержащий прописные или строчные буквы алфавита в лямбда-выражение, которое выбирает буквы, равные или больше определенной буквы (например, "M"). Коллекция IEnumerable(Of String), возвращаемая методом Enumerable.Where, передается методу Join(String, IEnumerable<String>) для отображения результата в виде одной строки.

using System;
using System.Collections.Generic;
using System.Linq;

public class Example
{
   public static void Main()
   {
      string output = String.Join(" ", GetAlphabet(true).Where( letter => 
                      letter.CompareTo("M") >= 0));
      Console.WriteLine(output);  
   }

   private static List<string> GetAlphabet(bool upper)
   {
      List<string> alphabet = new List<string>();
      int charValue = upper ? 65 : 97;
      for (int ctr = 0; ctr <= 25; ctr++)
         alphabet.Add(((char)(charValue + ctr)).ToString());
      return alphabet; 
   }
}
// The example displays the following output:
//      M N O P Q R S T U V W X Y Z

См. также раздел

• Split(Char[])

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join (char separator, params object?[] values);

public static string Join (char separator, params object[] values);

Параметры

Возвращаемое значение

Строка, состоящая из элементов values, разделенных символом separator.

-или-

Empty, если values имеет нулевые элементы.

Исключения

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join (string separator, params object[] values);

public static string Join (string? separator, params object?[] values);

[System.Runtime.InteropServices.ComVisible(false)]
public static string Join (string separator, params object[] values);

Параметры

Возвращаемое значение

Строка, состоящая из элементов values, разделенных строкой separator.

-или-

Empty, если values имеет нулевые элементы.

-или-

Только .NET Framework: Empty, если первый элемент valuesnull.

Атрибуты

ComVisibleAttribute

Исключения

Примеры

В следующем примере используется алгоритм Sieve eratosthenes для вычисления простых чисел, которые меньше или равны 100. Он назначает результат целочисленным массиву, который затем передается в метод Join(String, Object[]).

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main()
   {
      int maxPrime = 100;
      int[] primes = GetPrimes(maxPrime);
      Console.WriteLine("Primes less than {0}:", maxPrime);
      Console.WriteLine("   {0}", String.Join(" ", primes));
   }

   private static int[] GetPrimes(int maxPrime)
   {
      Array values = Array.CreateInstance(typeof(int), 
                              new int[] { maxPrime - 1}, new int[] { 2 }); 
      // Use Sieve of Eratosthenes to determine prime numbers.
      for (int ctr = values.GetLowerBound(0); ctr <= (int) Math.Ceiling(Math.Sqrt(values.GetUpperBound(0))); ctr++)
      {
                           
         if ((int) values.GetValue(ctr) == 1) continue;
         
         for (int multiplier = ctr; multiplier <=  maxPrime / 2; multiplier++)
            if (ctr * multiplier <= maxPrime)
               values.SetValue(1, ctr * multiplier);
      }      
      
      List<int> primes = new List<int>();
      for (int ctr = values.GetLowerBound(0); ctr <= values.GetUpperBound(0); ctr++)
         if ((int) values.GetValue(ctr) == 0) 
            primes.Add(ctr);
      return primes.ToArray();
   }   
}
// The example displays the following output:
//    Primes less than 100:
//       2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97

Комментарии

Если separatornull или какой-либо элемент values, отличный от первого элемента, null, используется пустая строка (String.Empty) вместо него. См. раздел "Заметки для вызывающих абонентов", если первый элемент valuesnull.

Join(String, Object[]) — это удобный метод, позволяющий объединять каждый элемент в массиве объектов без явного преобразования элементов в строки. Строковое представление каждого объекта в массиве является производным путем вызова метода ToString этого объекта.

Примечания для тех, кто вызывает этот метод

Только .NET Framework: если первый элемент valuesnull, метод Join(String, Object[]) не объединяет элементы в values, а возвращает Empty. Доступны ряд обходных решений для этой проблемы. Проще всего назначить значение Empty первому элементу массива, как показано в следующем примере.

object[] values = { null, "Cobb", 4189, 11434, .366 };
if (values[0] == null) values[0] = String.Empty;
Console.WriteLine(String.Join("|", values));

// The example displays the following output:
//      |Cobb|4189|11434|0.366

См. также раздел

• Split(Char[])

public static string Join (char separator, scoped ReadOnlySpan<string?> value);

Параметры

Возвращаемое значение

Строка, состоящая из элементов value, разделенных строкой separator. -или- Empty, если value имеет нулевые элементы.

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join (char separator, params string?[] value);

public static string Join (char separator, params string[] value);

Параметры

Возвращаемое значение

Строка, состоящая из элементов value, разделенных символом separator.

-или-

Empty, если value имеет нулевые элементы.

Исключения

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join<T> (char separator, System.Collections.Generic.IEnumerable<T> values);

Параметры типа

Параметры

Возвращаемое значение

Строка, состоящая из элементов values, разделенных символом separator.

-или-

Empty, если values не имеет элементов.

Исключения

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

Исходный код:

String.Manipulation.cs

public static string Join<T> (string separator, System.Collections.Generic.IEnumerable<T> values);

public static string Join<T> (string? separator, System.Collections.Generic.IEnumerable<T> values);

[System.Runtime.InteropServices.ComVisible(false)]
public static string Join<T> (string separator, System.Collections.Generic.IEnumerable<T> values);

Параметры типа

Параметры

Возвращаемое значение

Строка, состоящая из элементов values, разделенных строкой separator.

-или-

Empty, если values не имеет элементов.

Атрибуты

ComVisibleAttribute

Исключения

Примеры

В следующем примере используется алгоритм Sieve eratosthenes для вычисления простых чисел, которые меньше или равны 100. Он назначает результат объекту List<T> целочисленного типа, который затем передается в метод Join<T>(String, IEnumerable<T>).

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main()
   {
      int maxPrime = 100;
      List<int> primes = GetPrimes(maxPrime);
      Console.WriteLine("Primes less than {0}:", maxPrime);
      Console.WriteLine("   {0}", String.Join(" ", primes));
   }

   private static List<int> GetPrimes(int maxPrime)
   {
      Array values = Array.CreateInstance(typeof(int), 
                              new int[] { maxPrime - 1}, new int[] { 2 });
      // Use Sieve of Eratosthenes to determine prime numbers.
      for (int ctr = values.GetLowerBound(0); ctr <= (int) Math.Ceiling(Math.Sqrt(values.GetUpperBound(0))); ctr++)
      {
                           
         if ((int) values.GetValue(ctr) == 1) continue;
         
         for (int multiplier = ctr; multiplier <=  maxPrime / 2; multiplier++)
            if (ctr * multiplier <= maxPrime)
               values.SetValue(1, ctr * multiplier);
      }      
      
      List<int> primes = new List<int>();
      for (int ctr = values.GetLowerBound(0); ctr <= values.GetUpperBound(0); ctr++)
         if ((int) values.GetValue(ctr) == 0) 
            primes.Add(ctr);
      return primes;
   }   
}
// The example displays the following output:
//    Primes less than 100:
//       2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97

Комментарии

Если separatornull, вместо этого используется пустая строка (String.Empty). Если любой элемент valuesnull, вместо этого используется пустая строка.

Join<T>(String, IEnumerable<T>) — это удобный метод, позволяющий объединить каждый элемент коллекции IEnumerable<T> без первого преобразования их в строки. Строковое представление каждого объекта в коллекции IEnumerable<T> является производным путем вызова метода ToString этого объекта.

Этот метод особенно полезен для выражений запросов Language-Integrated (LINQ). Например, следующий код определяет очень простой класс Animal, содержащий имя животного и порядок, к которому он принадлежит. Затем он определяет объект List<T>, содержащий ряд объектов Animal. Метод расширения Enumerable.Where вызывается для извлечения объектов Animal, свойство Order которого равно Rodent. Результат передается методу Join<T>(String, IEnumerable<T>).

using System;
using System.Collections.Generic;
using System.Linq;

public class Animal
{
   public string Kind;
   public string Order;
   
   public Animal(string kind, string order)
   {
      this.Kind = kind;
      this.Order = order;
   }
   
   public override string ToString()
   {
      return this.Kind;
   }
}

public class Example
{
   public static void Main()
   {
      List<Animal> animals = new List<Animal>();
      animals.Add(new Animal("Squirrel", "Rodent"));
      animals.Add(new Animal("Gray Wolf", "Carnivora"));
      animals.Add(new Animal("Capybara", "Rodent"));
      string output = String.Join(" ", animals.Where( animal => 
                      (animal.Order == "Rodent")));
      Console.WriteLine(output);  
   }
}
// The example displays the following output:
//      Squirrel Capybara

См. также раздел

• Split(Char[])