String.Join Methode

Definitie

Voegt de elementen van een opgegeven matrix of de leden van een verzameling samen met behulp van het opgegeven scheidingsteken tussen elk element of lid.

Overloads

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

Voegt de opgegeven elementen van een tekenreeksmatrix samen met behulp van het opgegeven scheidingsteken tussen elk element.

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

Voegt een matrix van tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid, te beginnen met het element op value de startIndex positie en het samenvoegen van elementen count .

Join(String, String[])

Voegt alle elementen van een tekenreeksmatrix samen met behulp van het opgegeven scheidingsteken tussen elk element.

Join(String, ReadOnlySpan<String>)

Voegt een reeks tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid.

Join(String, ReadOnlySpan<Object>)

Voegt de tekenreeksweergaven van een reeks objecten samen met behulp van het opgegeven scheidingsteken tussen elk lid.

Join(Char, ReadOnlySpan<String>)

Voegt een reeks tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid.

Join(String, IEnumerable<String>)

Voegt de leden van een samengestelde IEnumerable<T> verzameling van het type Stringsamen met behulp van het opgegeven scheidingsteken tussen elk lid.

Join(Char, String[])

Voegt een matrix van tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid.

Join(String, Object[])

Voegt de elementen van een objectmatrix samen met behulp van het opgegeven scheidingsteken tussen elk element.

Join(Char, ReadOnlySpan<Object>)

Voegt de tekenreeksweergaven van een reeks objecten samen met behulp van het opgegeven scheidingsteken tussen elk lid.

Join(Char, Object[])

Voegt de tekenreeksweergaven van een matrix met objecten samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Voegt de leden van een verzameling samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Voegt de leden van een verzameling samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt de opgegeven elementen van een tekenreeksmatrix samen met behulp van het opgegeven scheidingsteken tussen elk element.

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

Parameters

separator
String

De tekenreeks die moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als value er meer dan één element is.

value
String[]

Een matrix die de elementen bevat die moeten worden samengevoegd.

startIndex
Int32

Het eerste element dat moet value worden gebruikt.

count
Int32

Het aantal elementen dat value moet worden gebruikt.

Retouren

Een tekenreeks die bestaat uit count elementen die value beginnen bij startIndex scheidingstekens door het separator teken.

– of –

Empty als count het nul is.

Uitzonderingen

value is null.

startIndex of count kleiner is dan 0.

– of –

startIndex plus count is groter dan het aantal elementen in value.

Geen geheugen meer.

Voorbeelden

In het volgende voorbeeld worden twee elementen samengevoegd uit een matrix met namen van fruit.

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'

Opmerkingen

Als bijvoorbeeld separator ', ' en de elementen value zijn 'appel', 'oranje', 'druif' en 'peren', Join(separator, value, 1, 2) retourneert 'sinaasappel, druif'.

Als separator dat het is null, wordt in plaats daarvan een lege tekenreeks (String.Empty) gebruikt. Als er een element is valuenull, wordt in plaats daarvan een lege tekenreeks gebruikt.

Zie ook

Van toepassing op

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

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt een matrix van tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid, te beginnen met het element op value de startIndex positie en het samenvoegen van elementen 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

Parameters

separator
Char

Voegt een matrix van tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid, te beginnen met het element dat zich in de opgegeven index bevindt en een opgegeven aantal elementen bevat.

value
String[]

Een matrix met tekenreeksen die moeten worden samengevoegd.

startIndex
Int32

Het eerste item dat moet value worden samengevoegd.

count
Int32

Het aantal elementen dat value moet worden samengevoegd, beginnend met het element in de startIndex positie.

Retouren

Een tekenreeks die bestaat uit count elementen die value beginnen bij startIndex scheidingstekens door het separator teken.

– of –

Empty als count het nul is.

Uitzonderingen

value is null.

startIndex of count negatief zijn.

– of –

startIndex is groter dan de lengte van value - count.

De lengte van de resulterende tekenreeks overloopt de maximaal toegestane lengte (Int32.MaxValue).

Van toepassing op

Join(String, String[])

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt alle elementen van een tekenreeksmatrix samen met behulp van het opgegeven scheidingsteken tussen elk element.

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

Parameters

separator
String

De tekenreeks die moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als value er meer dan één element is.

value
String[]

Een matrix die de elementen bevat die moeten worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen die value zijn gescheiden door de separator tekenreeks.

– of –

Empty als value er nulelementen zijn.

Uitzonderingen

value is null.

De lengte van de resulterende tekenreeks overloopt de maximaal toegestane lengte (Int32.MaxValue).

Voorbeelden

In het volgende voorbeeld ziet u de Join methode.

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

Opmerkingen

Als bijvoorbeeld separator ', ' en de elementen value zijn 'appel', 'oranje', 'druif' en 'peren', Join(separator, value) retourneert 'appel, sinaasappel, druif, peer'.

Als separator dat het is null, wordt in plaats daarvan een lege tekenreeks (String.Empty) gebruikt. Als er een element is valuenull, wordt in plaats daarvan een lege tekenreeks gebruikt.

Zie ook

Van toepassing op

Join(String, ReadOnlySpan<String>)

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt een reeks tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Parameters

separator
String

De tekenreeks die moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als value er meer dan één element is.

value
ReadOnlySpan<String>

Een bereik dat de elementen bevat die moeten worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van value gescheiden door de separator tekenreeks. -of- Empty als value er nul elementen zijn.

Van toepassing op

Join(String, ReadOnlySpan<Object>)

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt de tekenreeksweergaven van een reeks objecten samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Parameters

separator
String

De tekenreeks die moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als values er meer dan één element is.

values
ReadOnlySpan<Object>

Een reeks objecten waarvan de tekenreeksweergaven worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van values gescheiden door de separator tekenreeks. -of- Empty als values er nul elementen zijn.

Van toepassing op

Join(Char, ReadOnlySpan<String>)

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt een reeks tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Parameters

separator
Char

Het teken dat moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als value er meer dan één element is.

value
ReadOnlySpan<String>

Een bereik dat de elementen bevat die moeten worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van value gescheiden door de separator tekenreeks. -of- Empty als value er nul elementen zijn.

Van toepassing op

Join(String, IEnumerable<String>)

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt de leden van een samengestelde IEnumerable<T> verzameling van het type Stringsamen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Parameters

separator
String

De tekenreeks die moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als values er meer dan één element is.

values
IEnumerable<String>

Een verzameling die de tekenreeksen bevat die moeten worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van values gescheiden door de separator tekenreeks.

– of –

Empty als values er nulelementen zijn.

Kenmerken

Uitzonderingen

values is null.

De lengte van de resulterende tekenreeks overloopt de maximaal toegestane lengte (Int32.MaxValue).

Voorbeelden

In het volgende voorbeeld wordt het algoritme Sieve of Eratosthenes gebruikt om de priemgetallen te berekenen die kleiner zijn dan of gelijk zijn aan 100. Het resultaat wordt toegewezen aan een object van het List<T> type String, dat vervolgens wordt doorgegeven aan de Join(String, IEnumerable<String>) methode.

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

Opmerkingen

Als separator dat het is null, wordt in plaats daarvan een lege tekenreeks (String.Empty) gebruikt. Als een lid values is null, wordt in plaats daarvan een lege tekenreeks gebruikt.

Join(String, IEnumerable<String>) is een handige methode waarmee u elk element in een IEnumerable(Of String) verzameling kunt samenvoegen zonder eerst de elementen te converteren naar een tekenreeksmatrix. Dit is met name handig bij Language-Integrated QUERY-expressies (LINQ). In het volgende voorbeeld wordt een List(Of String) object met hoofdletters of kleine letters van het alfabet doorgegeven aan een lambda-expressie die letters selecteert die gelijk zijn aan of groter zijn dan een bepaalde letter (in het voorbeeld 'M'). De IEnumerable(Of String) verzameling die door de Enumerable.Where methode wordt geretourneerd, wordt doorgegeven aan de Join(String, IEnumerable<String>) methode om het resultaat weer te geven als één tekenreeks.

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

Zie ook

Van toepassing op

Join(Char, String[])

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt een matrix van tekenreeksen samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Parameters

separator
Char

Het teken dat moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als value er meer dan één element is.

value
String[]

Een matrix met tekenreeksen die moeten worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van value gescheiden door het separator teken.

– of –

Empty als value er nulelementen zijn.

Uitzonderingen

value is null.

De lengte van de resulterende tekenreeks overloopt de maximaal toegestane lengte (Int32.MaxValue).

Van toepassing op

Join(String, Object[])

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt de elementen van een objectmatrix samen met behulp van het opgegeven scheidingsteken tussen elk element.

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

Parameters

separator
String

De tekenreeks die moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als values er meer dan één element is.

values
Object[]

Een matrix die de elementen bevat die moeten worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van values gescheiden door de separator tekenreeks.

– of –

Empty als values er nulelementen zijn.

– of –

alleen .NET Framework: Empty als het eerste element van valuesnull is.

Kenmerken

Uitzonderingen

values is null.

De lengte van de resulterende tekenreeks overloopt de maximaal toegestane lengte (Int32.MaxValue).

Voorbeelden

In het volgende voorbeeld wordt het algoritme Sieve of Eratosthenes gebruikt om de priemgetallen te berekenen die kleiner zijn dan of gelijk zijn aan 100. Het resultaat wordt toegewezen aan een matrix met gehele getallen, die vervolgens wordt doorgegeven aan de Join(String, Object[]) methode.

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

Opmerkingen

Als separator dat het geval is null of als een ander element values dan het eerste element is null, wordt in plaats daarvan een lege tekenreeks (String.Empty) gebruikt. Zie de sectie Notities voor bellers als het eerste element values is null.

Join(String, Object[]) is een handige methode waarmee u elk element in een objectmatrix kunt samenvoegen zonder de elementen expliciet te converteren naar tekenreeksen. De tekenreeksweergave van elk object in de matrix wordt afgeleid door de methode van ToString dat object aan te roepen.

Notities voor bellers

alleen .NET Framework: als het eerste element van values is null, voegt de methode Join(String, Object[]) de elementen in values niet samen, maar retourneert in plaats daarvan Empty. Er zijn een aantal tijdelijke oplossingen beschikbaar voor dit probleem. Het eenvoudigst is om een waarde toe Empty te wijzen aan het eerste element van de matrix, zoals in het volgende voorbeeld wordt weergegeven.

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

Zie ook

Van toepassing op

Join(Char, ReadOnlySpan<Object>)

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt de tekenreeksweergaven van een reeks objecten samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Parameters

separator
Char

Het teken dat moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als de waarde meer dan één element heeft.

values
ReadOnlySpan<Object>

Een reeks objecten waarvan de tekenreeksweergaven worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van values gescheiden door het separator teken. -of- Empty als values er nul elementen zijn.

Van toepassing op

Join(Char, Object[])

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt de tekenreeksweergaven van een matrix met objecten samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Parameters

separator
Char

Het teken dat moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als values er meer dan één element is.

values
Object[]

Een matrix van objecten waarvan de tekenreeksweergaven worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van values gescheiden door het separator teken.

– of –

Empty als values er nulelementen zijn.

Uitzonderingen

values is null.

De lengte van de resulterende tekenreeks overloopt de maximaal toegestane lengte (Int32.MaxValue).

Van toepassing op

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

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt de leden van een verzameling samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Type parameters

T

Het type van de leden van values.

Parameters

separator
Char

Het teken dat moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als values er meer dan één element is.

values
IEnumerable<T>

Een verzameling die de objecten bevat die moeten worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de leden van values gescheiden door het separator teken.

– of –

Empty als values er geen elementen zijn.

Uitzonderingen

values is null.

De lengte van de resulterende tekenreeks overloopt de maximaal toegestane lengte (Int32.MaxValue).

Van toepassing op

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

Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs
Bron:
String.Manipulation.cs

Voegt de leden van een verzameling samen met behulp van het opgegeven scheidingsteken tussen elk lid.

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

Type parameters

T

Het type van de leden van values.

Parameters

separator
String

De tekenreeks die moet worden gebruikt als scheidingsteken. separator is alleen opgenomen in de geretourneerde tekenreeks als values er meer dan één element is.

values
IEnumerable<T>

Een verzameling die de objecten bevat die moeten worden samengevoegd.

Retouren

Een tekenreeks die bestaat uit de elementen van values gescheiden door de separator tekenreeks.

– of –

Empty als values er geen elementen zijn.

Kenmerken

Uitzonderingen

values is null.

De lengte van de resulterende tekenreeks overloopt de maximaal toegestane lengte (Int32.MaxValue).

Voorbeelden

In het volgende voorbeeld wordt het algoritme Sieve of Eratosthenes gebruikt om de priemgetallen te berekenen die kleiner zijn dan of gelijk zijn aan 100. Het resultaat wordt toegewezen aan een object van het List<T> type integer, dat vervolgens wordt doorgegeven aan de Join<T>(String, IEnumerable<T>) methode.

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

Opmerkingen

Als separator dat het is null, wordt in plaats daarvan een lege tekenreeks (String.Empty) gebruikt. Als een lid values is null, wordt in plaats daarvan een lege tekenreeks gebruikt.

Join<T>(String, IEnumerable<T>) is een handige methode waarmee u elk lid van een IEnumerable<T> verzameling kunt samenvoegen zonder ze eerst te converteren naar tekenreeksen. De tekenreeksweergave van elk object in de IEnumerable<T> verzameling wordt afgeleid door de methode van ToString dat object aan te roepen.

Deze methode is met name handig bij Language-Integrated Query-expressies (LINQ). Met de volgende code wordt bijvoorbeeld een zeer eenvoudige Animal klasse gedefinieerd die de naam van een dier bevat en de volgorde waartoe het behoort. Vervolgens wordt een List<T> object gedefinieerd dat een aantal Animal objecten bevat. De Enumerable.Where extensiemethode wordt aangeroepen om de objecten te extraheren waarvan Animal de Order eigenschap gelijk is aan Knaagdieren. Het resultaat wordt doorgegeven aan de Join<T>(String, IEnumerable<T>) methode.

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

Zie ook

Van toepassing op