分享方式

String.Join 方法

定義

命名空間:
System
組件:
mscorlib.dll, System.Runtime.dll
組件:
netstandard.dll, System.Runtime.dll
組件:
System.Runtime.dll
組件:
mscorlib.dll
組件:
netstandard.dll

使用每個專案或成員之間的指定分隔符，串連指定數位的專案或集合的成員。

多載

名稱 Description
Join(String, String[], Int32, Int32)

使用每個元素之間的指定分隔符，串連字串陣列的指定專案。
Join(Char, String[], Int32, Int32)

串接一組字串，使用每個成員間指定的分隔符，從位於該startIndex位置的元素value開始，串接至count元素。
Join(String, String[])

使用每個元素之間的指定分隔符，串連字串陣列的所有元素。
Join(String, ReadOnlySpan<String>)

使用每個成員之間的指定分隔符，串連字串範圍。
Join(String, ReadOnlySpan<Object>)

使用每個成員之間的指定分隔符，串連物件範圍的字串表示。
Join(Char, ReadOnlySpan<String>)

使用每個成員之間的指定分隔符，串連字串範圍。
Join(String, IEnumerable<String>)

利用指定的分隔符串接一個型別String為 的構造IEnumerable<T>集合的成員。
Join(Char, String[])

使用每個成員之間的指定分隔符串連字串陣列。
Join(String, Object[])

使用每個項目之間的指定分隔符，串連物件數位的專案。
Join(Char, ReadOnlySpan<Object>)

使用每個成員之間的指定分隔符，串連物件範圍的字串表示。
Join(Char, Object[])

使用每個成員之間的指定分隔符，串連 物件陣列的字串表示。
Join<T>(Char, IEnumerable<T>)

使用每個成員之間的指定分隔符，串連集合的成員。
Join<T>(String, IEnumerable<T>)

使用每個成員之間的指定分隔符，串連集合的成員。

Join(String, String[], Int32, Int32)

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

使用每個元素之間的指定分隔符，串連字串陣列的指定專案。

public:
 static System::String ^ Join(System::String ^ separator, cli::array <System::String ^> ^ value, int startIndex, int count);
public static string Join(string separator, string[] value, int startIndex, int count);
public static string Join(string? separator, string?[] value, int startIndex, int count);
static member Join : string * string[] * int * int -> string
Public Shared Function Join (separator As String, value As String(), startIndex As Integer, count As Integer) As String

參數

separator
String

要當做分隔符使用的字串。 separator 只有當 value 有多個元素時才會包含在回傳的字串中。

value
String[]

陣列，其中包含要串連的專案。

startIndex
Int32

這是第一個要 value 使用的元素。

count
Int32

要用的 value 元素數量。

傳回

String

一個由以 value 為 以字元為startIndex界定separator的元素組成count的字串。

-或-

Empty 若為 count 零。

例外狀況

ArgumentNullException

value 為 null。

ArgumentOutOfRangeException

startIndex 或 count 小於0。

-或-

startIndex plus count 大於 中的 value元素數。

OutOfMemoryException

記憶體不足。

範例

下列範例會串連水果名稱陣列中的兩個元素。

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'

open System

let vals = [| "apple"; "orange"; "grape"; "pear" |]
let sep   = ", "

printfn $"sep = '{sep}'"
printfn $"vals[] = {{'{vals[0]}' '{vals[1]}' '{vals[2]}' '{vals[3]}'}}"
let result = String.Join(sep, vals, 1, 2)
printfn $"String.Join(sep, vals, 1, 2) = '{result}'"

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

Class Sample
   Public Shared Sub Main()
      Dim val As [String]() =  {"apple", "orange", "grape", "pear"}
      Dim sep As [String] = ", "
      Dim result As [String]

      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)
   End Sub
End Class

'This example displays the following output:
'       sep = ', '
'       val() = {'apple' 'orange' 'grape' 'pear'}
'       String.Join(sep, val, 1, 2) = 'orange, grape'

備註

例如，若 separator 是 「，」且元素 value 為「apple」、「orange」、「grape」和「pear」，則 Join(separator, value, 1, 2) 回傳「orange， grape」。

若 separator 是 null，則使用空字串 （String.Empty） 代替。 若 中 value 任一元素為 null，則使用空字串。

另請參閱

適用於

Join(Char, String[], Int32, Int32)

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

串接一組字串，使用每個成員間指定的分隔符，從位於該startIndex位置的元素value開始，串接至count元素。

public:
 static System::String ^ Join(char separator, cli::array <System::String ^> ^ value, int startIndex, int count);
public static string Join(char separator, string?[] value, int startIndex, int count);
public static string Join(char separator, string[] value, int startIndex, int count);
static member Join : char * string[] * int * int -> string
Public Shared Function Join (separator As Char, value As String(), startIndex As Integer, count As Integer) As String

參數

separator
Char

使用每個成員之間的指定分隔符串連字串陣列，從位於指定索引處的項目開始，並包含指定的項目數目。

value
String[]

要串連的字串陣列。

startIndex
Int32

第一個被 value 串接的項目。

count
Int32

從 value 到 的元素數，從該位置的元素 startIndex 開始串接。

傳回

String

一個由以 value 為 以字元為startIndex界定separator的元素組成count的字串。

-或-

Empty 若為 count 零。

例外狀況

ArgumentNullException

value 為 null。

ArgumentOutOfRangeException

startIndex 或 count 是負值。

-或-

startIndex 大於 的 value - count長度。

OutOfMemoryException

所得字串的長度會超過最大允許長度（Int32.MaxValue）。

適用於

Join(String, String[])

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

使用每個元素之間的指定分隔符，串連字串陣列的所有元素。

public:
 static System::String ^ Join(System::String ^ separator, ... cli::array <System::String ^> ^ value);
public:
 static System::String ^ Join(System::String ^ separator, cli::array <System::String ^> ^ value);
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);
static member Join : string * string[] -> string
Public Shared Function Join (separator As String, ParamArray value As String()) As String
Public Shared Function Join (separator As String, value As String()) As String

參數

separator
String

要當做分隔符使用的字串。 separator 只有當 value 有多個元素時才會包含在回傳的字串中。

value
String[]

陣列，其中包含要串連的專案。

傳回

String

一個由 中 value 元素 separator 組成的字串。

-或-

Empty 若 value 為零元素。

例外狀況

ArgumentNullException

value 為 null。

OutOfMemoryException

所得字串的長度會超過最大允許長度（Int32.MaxValue）。

範例

以下範例示範此 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

open System

let makeLine initVal multVal (sep: string) =
    let sArr = Array.zeroCreate<string> 10 

    for i = initVal to initVal + 9 do
        sArr[i - initVal] <- String.Format("{0,-3}", i * multVal)

    String.Join(sep, sArr)

printfn $"""{makeLine 0 5 ", "}"""
printfn $"""{makeLine 1 6 "  "}"""
printfn $"""{makeLine 9 9 ": "}"""
printfn $"""{makeLine 4 7 "< "}"""

// 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

Public Class JoinTest
    
    Public Shared Sub Main()
        
        Console.WriteLine(MakeLine(0, 5, ", "))
        Console.WriteLine(MakeLine(1, 6, "  "))
        Console.WriteLine(MakeLine(9, 9, ": "))
        Console.WriteLine(MakeLine(4, 7, "< "))
    End Sub
    
    
    Private Shared Function MakeLine(initVal As Integer, multVal As Integer, sep As String) As String
        Dim sArr(10) As String
        Dim i As Integer
        
        
        For i = initVal To (initVal + 10) - 1
            sArr((i - initVal)) = [String].Format("{0,-3}", i * multVal)
        
        Next i
        Return [String].Join(sep, sArr)
    End Function 'MakeLine
End Class
' 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 為「apple」、「orange」、「grape」和「pear」，則 Join(separator, value) 回傳「apple， orange， grape， pear」。

若 separator 是 null，則使用空字串 （String.Empty） 代替。 若 中 value 任一元素為 null，則使用空字串。

另請參閱

適用於

Join(String, ReadOnlySpan<String>)

來源:
String.Manipulation.cs

使用每個成員之間的指定分隔符，串連字串範圍。

public:
 static System::String ^ Join(System::String ^ separator, ReadOnlySpan<System::String ^> value);
public static string Join(string? separator, scoped ReadOnlySpan<string?> value);
static member Join : string * ReadOnlySpan<string> -> string
Public Shared Function Join (separator As String, value As ReadOnlySpan(Of String)) As String

參數

separator
String

要當做分隔符使用的字串。 separator 只有當 value 有多個元素時才會包含在回傳的字串中。

value
ReadOnlySpan<String>

範圍，包含要串連的專案。

傳回

String

一個由 元素valueseparator組成的字串。 -或者- Empty 如果 value 元素為零。

適用於

Join(String, ReadOnlySpan<Object>)

來源:
String.Manipulation.cs

使用每個成員之間的指定分隔符，串連物件範圍的字串表示。

public:
 static System::String ^ Join(System::String ^ separator, ReadOnlySpan<System::Object ^> values);
public static string Join(string? separator, scoped ReadOnlySpan<object?> values);
static member Join : string * ReadOnlySpan<obj> -> string
Public Shared Function Join (separator As String, values As ReadOnlySpan(Of Object)) As String

參數

separator
String

要當做分隔符使用的字串。 separator 只有當 values 有多個元素時才會包含在回傳的字串中。

values
ReadOnlySpan<Object>

對象的範圍，其字串表示將會串連。

傳回

String

一個由 元素valuesseparator組成的字串。 -或者- Empty 如果 values 元素為零。

適用於

Join(Char, ReadOnlySpan<String>)

來源:
String.Manipulation.cs

使用每個成員之間的指定分隔符，串連字串範圍。

public:
 static System::String ^ Join(char separator, ReadOnlySpan<System::String ^> value);
public static string Join(char separator, scoped ReadOnlySpan<string?> value);
static member Join : char * ReadOnlySpan<string> -> string
Public Shared Function Join (separator As Char, value As ReadOnlySpan(Of String)) As String

參數

separator
Char

要當做分隔符使用的字元。 separator 只有當 value 有多個元素時才會包含在回傳的字串中。

value
ReadOnlySpan<String>

範圍，包含要串連的專案。

傳回

String

一個由 元素valueseparator組成的字串。 -或者- Empty 如果 value 元素為零。

適用於

Join(String, IEnumerable<String>)

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

利用指定的分隔符串接一個型別String為 的構造IEnumerable<T>集合的成員。

public:
 static System::String ^ Join(System::String ^ separator, System::Collections::Generic::IEnumerable<System::String ^> ^ values);
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);
static member Join : string * seq<string> -> string
[<System.Runtime.InteropServices.ComVisible(false)>]
static member Join : string * seq<string> -> string
Public Shared Function Join (separator As String, values As IEnumerable(Of String)) As String

參數

separator
String

要當做分隔符使用的字串。 separator 只有當 values 有多個元素時才會包含在回傳的字串中。

values
IEnumerable<String>

集合，其中包含要串連的字串。

傳回

String

一個由 元素valuesseparator組成的字串。

-或-

Empty 若 values 為零元素。

屬性
ComVisibleAttribute

例外狀況

ArgumentNullException

values 為 null。

OutOfMemoryException

所得字串的長度會超過最大允許長度（Int32.MaxValue）。

範例

下列範例會使用 Eratosthenes 演算法的 Sieve 來計算小於或等於 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

open System

let getPrimes maxPrime =
    let values = Array.CreateInstance(typeof<int>, [| maxPrime - 1 |], [| 2 |])
    // Use Sieve of Eratosthenes to determine prime numbers.
    for i = values.GetLowerBound 0 to values.GetUpperBound 0 |> float |> sqrt |> ceil |> int do
        if values.GetValue i :?> int <> 1 then
            for multiplier = i to maxPrime / 2 do
                if i * multiplier <= maxPrime then
                    values.SetValue(1, i * multiplier)

    let primes = ResizeArray()
    for i = values.GetLowerBound 0 to values.GetUpperBound 0 do
        if values.GetValue i :?> int = 0 then
            primes.Add i
    primes

let maxPrime = 100
let primes = getPrimes maxPrime
printfn $"Primes less than {maxPrime}:"
printfn $"""   {String.Join(" ", 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

Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim maxPrime As Integer = 100
      Dim primes As List(Of String) = GetPrimes(maxPrime)
      Console.WriteLine("Primes less than {0}:", maxPrime)
      Console.WriteLine("   {0}", String.Join(" ", primes))
   End Sub

   Private Function GetPrimes(maxPrime As Integer) As List(Of String)
      Dim values As Array = Array.CreateInstance(GetType(Integer), _
                              New Integer() { maxPrime - 1}, New Integer(){ 2 })
        ' Use Sieve of Eratosthenes to determine prime numbers.
      For ctr As Integer = values.GetLowerBound(0) To _
                           CInt(Math.Ceiling(Math.Sqrt(values.GetUpperBound(0))))
         If CInt(values.GetValue(ctr)) = 1 Then Continue For

         For multiplier As Integer = ctr To maxPrime \ 2
            If ctr * multiplier <= maxPrime Then values.SetValue(1, ctr * multiplier)
         Next
      Next

      Dim primes As New List(Of String)
      For ctr As Integer = values.GetLowerBound(0) To values.GetUpperBound(0)
         If CInt(values.GetValue(ctr)) = 0 Then primes.Add(ctr.ToString())
      Next
      Return primes
   End Function
End Module

' 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

備註

若 separator 是 null，則使用空字串 （String.Empty） 代替。 若 的 values 任一成員為 null，則使用空字串。

Join(String, IEnumerable<String>) 這是一種方便的方法，讓你可以將集合中的 IEnumerable(Of String) 每個元素串接起來，而不必先將元素轉換成字串陣列。 它特別適合用於 Language-Integrated 查詢（LINQ）查詢表達式。 以下範例將包含 List(Of String) 字母表大寫或小寫字母的物件傳遞給一個 lambda 運算式，該表達式選擇等於或大於某個特定字母的字母（在本例中為「M」）。 方法回傳Enumerable.Where的IEnumerable(Of String)集合會傳給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

// This F# example uses Seq.filter instead of Linq.
open System

let getAlphabet upper =
    let charValue = if upper then 65 else 97
    seq {
        for i = 0 to 25 do
            charValue + i
            |> char
            |> string
    }

String.Join(" ", getAlphabet true |> Seq.filter (fun letter -> letter.CompareTo "M" >= 0))
|> printfn "%s"

// The example displays the following output:
//      M N O P Q R S T U V W X Y Z

Imports System.Collections.Generic
Imports System.Linq

Module modMain
   Public Sub Main()
      Dim output As String = String.Join(" ", GetAlphabet(True).Where(Function(letter) _
                                                         letter >= "M"))

      Console.WriteLine(output)
   End Sub

   Private Function GetAlphabet(upper As Boolean) As List(Of String)
      Dim alphabet As New List(Of String)
      Dim charValue As Integer = CInt(IIf(upper, 65, 97))
      For ctr As Integer = 0 To 25
         alphabet.Add(ChrW(charValue + ctr).ToString())
      Next
      Return alphabet
   End Function
End Module

' The example displays the following output:
'      M N O P Q R S T U V W X Y Z

另請參閱

適用於

Join(Char, String[])

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

使用每個成員之間的指定分隔符串連字串陣列。

public:
 static System::String ^ Join(char separator, ... cli::array <System::String ^> ^ value);
public static string Join(char separator, params string?[] value);
public static string Join(char separator, params string[] value);
static member Join : char * string[] -> string
Public Shared Function Join (separator As Char, ParamArray value As String()) As String

參數

separator
Char

要當做分隔符使用的字元。 separator 只有當 value 有多個元素時才會包含在回傳的字串中。

value
String[]

要串連的字串陣列。

傳回

String

一個由 元素 value 組成的字串，由 以 字元分隔 separator 的元素組成。

-或-

Empty 若 value 為零元素。

例外狀況

ArgumentNullException

value 為 null。

OutOfMemoryException

所得字串的長度會超過最大允許長度（Int32.MaxValue）。

適用於

Join(String, Object[])

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

使用每個項目之間的指定分隔符，串連物件數位的專案。

public:
 static System::String ^ Join(System::String ^ separator, ... cli::array <System::Object ^> ^ values);
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);
static member Join : string * obj[] -> string
[<System.Runtime.InteropServices.ComVisible(false)>]
static member Join : string * obj[] -> string
Public Shared Function Join (separator As String, ParamArray values As Object()) As String

參數

separator
String

要當做分隔符使用的字串。 separator 只有當 values 有多個元素時才會包含在回傳的字串中。

values
Object[]

陣列，其中包含要串連的專案。

傳回

String

一個由 元素valuesseparator組成的字串。

-或-

Empty 若 values 為零元素。

-或-

僅 .NET Framework 時： Empty 若 的 values 第一個元素為 null。

屬性
ComVisibleAttribute

例外狀況

ArgumentNullException

values 為 null。

OutOfMemoryException

所得字串的長度會超過最大允許長度（Int32.MaxValue）。

範例

下列範例會使用 Eratosthenes 演算法的 Sieve 來計算小於或等於 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

open System

let getPrimes maxPrime =
    let values = Array.CreateInstance(typeof<int>, [| maxPrime - 1 |], [| 2 |])
    // Use Sieve of Eratosthenes to determine prime numbers.
    for i = values.GetLowerBound 0 to values.GetUpperBound 0 |> float |> sqrt |> ceil |> int do
        if values.GetValue i :?> int <> 1 then
            for multiplier = i to maxPrime / 2 do
                if i * multiplier <= maxPrime then
                    values.SetValue(1, i * multiplier)

    [| for i = values.GetLowerBound 0 to values.GetUpperBound 0 do
        if values.GetValue i :?> int = 0 then
            i |]

let maxPrime = 100
let primes = getPrimes maxPrime
printfn $"Primes less than {maxPrime}:"
printfn $"""   {String.Join(" ", 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

Module Example
   Public Sub Main()
      Dim maxPrime As Integer = 100
      Dim primes() As Integer = GetPrimes(maxPrime)
      Console.WriteLine("Primes less than {0}:", maxPrime)
      Console.WriteLine("   {0}", String.Join(" ", primes))
   End Sub

   Private Function GetPrimes(maxPrime As Integer) As Integer()
      Dim values As Array = Array.CreateInstance(GetType(Integer), _
                              New Integer() { maxPrime - 1}, New Integer(){ 2 })
        ' Use Sieve of Eratosthenes to determine prime numbers.
      For ctr As Integer = values.GetLowerBound(0) To _
                           CInt(Math.Ceiling(Math.Sqrt(values.GetUpperBound(0))))
         If CInt(values.GetValue(ctr)) = 1 Then Continue For

         For multiplier As Integer = ctr To maxPrime \ 2
            If ctr * multiplier <= maxPrime Then values.SetValue(1, ctr * multiplier)
         Next
      Next

      Dim primes As New System.Collections.Generic.List(Of Integer)
      For ctr As Integer = values.GetLowerBound(0) To values.GetUpperBound(0)
         If CInt(values.GetValue(ctr)) = 0 Then primes.Add(ctr)
      Next
      Return primes.ToArray()
   End Function
End Module

' 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

備註

若 separator 是 null ，或若 中 values 除第一個元素外的任何元素為 null，則使用空字串 （String.Empty） 代替。 如果 的 values 第一個元素是 null，請參見來電者備註章節。

Join(String, Object[]) 是一種方便的方法，讓你可以將物件陣列中的每個元素串接，而不必明確將其元素轉換成字串。 陣列中每個物件的字串表示是透過呼叫該物件的方法 ToString 推導出來的。

給呼叫者的注意事項

僅限 .NET Framework ：若 的 values 第一個元素為 null，該 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

let values: obj[] = [| null; "Cobb"; 4189; 11434; 0.366 |]
if values[0] = null then 
   values[0] <- String.Empty
printfn $"""{String.Join("|", values)}"""

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

Dim values() As Object = { Nothing, "Cobb", 4189, 11434, .366 }
If values(0) Is Nothing Then values(0) = String.Empty
Console.WriteLine(String.Join("|", values))
' The example displays the following output:
'      |Cobb|4189|11434|0.366

另請參閱

適用於

Join(Char, ReadOnlySpan<Object>)

來源:
String.Manipulation.cs

使用每個成員之間的指定分隔符，串連物件範圍的字串表示。

public:
 static System::String ^ Join(char separator, ReadOnlySpan<System::Object ^> values);
public static string Join(char separator, scoped ReadOnlySpan<object?> values);
static member Join : char * ReadOnlySpan<obj> -> string
Public Shared Function Join (separator As Char, values As ReadOnlySpan(Of Object)) As String

參數

separator
Char

要當做分隔符使用的字元。 separator 只有當值有多個元素時，才會包含在回傳的字串中。

values
ReadOnlySpan<Object>

對象的範圍，其字串表示將會串連。

傳回

String

一個由 元素 values 組成的字串，由 以 字元分隔 separator 的元素組成。 -或者- Empty 如果 values 元素為零。

適用於

Join(Char, Object[])

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

使用每個成員之間的指定分隔符，串連 物件陣列的字串表示。

public:
 static System::String ^ Join(char separator, ... cli::array <System::Object ^> ^ values);
public static string Join(char separator, params object?[] values);
public static string Join(char separator, params object[] values);
static member Join : char * obj[] -> string
Public Shared Function Join (separator As Char, ParamArray values As Object()) As String

參數

separator
Char

要當做分隔符使用的字元。 separator 只有當 values 有多個元素時才會包含在回傳的字串中。

values
Object[]

對象的陣列，其字串表示將會串連。

傳回

String

一個由 元素 values 組成的字串，由 以 字元分隔 separator 的元素組成。

-或-

Empty 若 values 為零元素。

例外狀況

ArgumentNullException

values 為 null。

OutOfMemoryException

所得字串的長度會超過最大允許長度（Int32.MaxValue）。

適用於

Join<T>(Char, IEnumerable<T>)

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

使用每個成員之間的指定分隔符，串連集合的成員。

public:
generic <typename T>
 static System::String ^ Join(char separator, System::Collections::Generic::IEnumerable<T> ^ values);
public static string Join<T>(char separator, System.Collections.Generic.IEnumerable<T> values);
static member Join : char * seq<'T> -> string
Public Shared Function Join(Of T) (separator As Char, values As IEnumerable(Of T)) As String

類型參數

T

成員類型 values。

參數

separator
Char

要當做分隔符使用的字元。 separator 只有當 values 有多個元素時才會包含在回傳的字串中。

values
IEnumerable<T>

集合，其中包含要串連的物件。

傳回

String

一個由 成員 values 組成的字串，由 以該字元分隔 separator 。

-或-

Empty 若 values 沒有元素。

例外狀況

ArgumentNullException

values 為 null。

OutOfMemoryException

所得字串的長度會超過最大允許長度（Int32.MaxValue）。

適用於

Join<T>(String, IEnumerable<T>)

來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs
來源:
String.Manipulation.cs

使用每個成員之間的指定分隔符，串連集合的成員。

public:
generic <typename T>
 static System::String ^ Join(System::String ^ separator, System::Collections::Generic::IEnumerable<T> ^ values);
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);
static member Join : string * seq<'T> -> string
[<System.Runtime.InteropServices.ComVisible(false)>]
static member Join : string * seq<'T> -> string
Public Shared Function Join(Of T) (separator As String, values As IEnumerable(Of T)) As String

類型參數

T

成員類型 values。

參數

separator
String

要當做分隔符使用的字串。 separator 只有當 values 有多個元素時才會包含在回傳的字串中。

values
IEnumerable<T>

集合，其中包含要串連的物件。

傳回

String

一個由 元素valuesseparator組成的字串。

-或-

Empty 若 values 沒有元素。

屬性
ComVisibleAttribute

例外狀況

ArgumentNullException

values 為 null。

OutOfMemoryException

所得字串的長度會超過最大允許長度（Int32.MaxValue）。

範例

下列範例會使用 Eratosthenes 演算法的 Sieve 來計算小於或等於 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

open System

let getPrimes maxPrime =
    let values = Array.CreateInstance(typeof<int>, [| maxPrime - 1 |], [| 2 |])
    // Use Sieve of Eratosthenes to determine prime numbers.
    for i = values.GetLowerBound 0 to values.GetUpperBound 0 |> float |> sqrt |> ceil |> int do
        if values.GetValue i <> 1 then
            for multiplier = i to maxPrime / 2 do
                if i * multiplier <= maxPrime then
                    values.SetValue(1, i * multiplier)

    let primes = ResizeArray()
    for i = values.GetLowerBound 0 to values.GetUpperBound 0 do
        if values.GetValue i :?> int = 0 then
            primes.Add i
    primes

let maxPrime = 100
let primes = getPrimes maxPrime
printfn $"Primes less than {maxPrime}:"
printfn $"""   {String.Join(" ", 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

Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim maxPrime As Integer = 100
      Dim primes As List(Of Integer) = GetPrimes(maxPrime)
      Console.WriteLine("Primes less than {0}:", maxPrime)
      Console.WriteLine("   {0}", String.Join(" ", primes))
   End Sub

   Private Function GetPrimes(maxPrime As Integer) As List(Of Integer)
      Dim values As Array = Array.CreateInstance(GetType(Integer), _
                              New Integer() { maxPrime - 1}, New Integer(){ 2 })
        ' Use Sieve of Eratosthenes to determine prime numbers.
      For ctr As Integer = values.GetLowerBound(0) To _
                           CInt(Math.Ceiling(Math.Sqrt(values.GetUpperBound(0))))
         If CInt(values.GetValue(ctr)) = 1 Then Continue For

         For multiplier As Integer = ctr To maxPrime \ 2
            If ctr * multiplier <= maxPrime Then values.SetValue(1, ctr * multiplier)
         Next
      Next

      Dim primes As New System.Collections.Generic.List(Of Integer)
      For ctr As Integer = values.GetLowerBound(0) To values.GetUpperBound(0)
         If CInt(values.GetValue(ctr)) = 0 Then primes.Add(ctr)
      Next
      Return primes
   End Function
End Module

' 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

備註

若 separator 是 null，則使用空字串 （String.Empty） 代替。 若 的 values 任一成員為 null，則使用空字串。

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

// This example uses F#'s Seq.filter function instead of Linq.
open System

type Animal =
  { Kind: string
    Order: string }
    override this.ToString() =
        this.Kind

let animals = ResizeArray()
animals.Add { Kind = "Squirrel"; Order = "Rodent" }
animals.Add { Kind = "Gray Wolf"; Order = "Carnivora" }
animals.Add { Kind = "Capybara"; Order = "Rodent" }
String.Join(" ", animals |> Seq.filter (fun animal -> animal.Order = "Rodent"))
|> printfn "%s"
// The example displays the following output:
//      Squirrel Capybara

Imports System.Collections.Generic

Public Class Animal
   Public Kind As String
   Public Order As String

   Public Sub New(kind As String, order As String)
      Me.Kind = kind
      Me.Order = order
   End Sub

   Public Overrides Function ToString() As String
      Return Me.Kind
   End Function
End Class

Module Example
   Public Sub Main()
      Dim animals As New List(Of Animal)
      animals.Add(New Animal("Squirrel", "Rodent"))
      animals.Add(New Animal("Gray Wolf", "Carnivora"))
      animals.Add(New Animal("Capybara", "Rodent"))
      Dim output As String = String.Join(" ", animals.Where(Function(animal) _
                                           animal.Order = "Rodent"))
      Console.WriteLine(output)
   End Sub
End Module

' The example displays the following output:
'      Squirrel Capybara

另請參閱

適用於