String.Join Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Verkettet die Elemente eines angegebenen Arrays oder die Member einer Auflistung und verwendet das angegebene Trennzeichen zwischen jedem Element bzw. Member.
Überlädt
Join(String, String[]) |
Verkettet alle Elemente eines Zeichenfolgenarrays und verwendet das angegebene Trennzeichen zwischen den einzelnen Elementen. |
Join(String, ReadOnlySpan<String>) | |
Join(String, String[], Int32, Int32) |
Verkettet die angegebenen Elemente eines Zeichenfolgenarrays und verwendet das angegebene Trennzeichen zwischen den einzelnen Elementen. |
Join(Char, String[], Int32, Int32) |
Verkettet ein Zeichenfolgenarray mithilfe der angegebenen Trennlinie zwischen den einzelnen Elementen. Dabei beginnt das Array mit dem Element in |
Join(String, ReadOnlySpan<Object>) | |
Join(Char, ReadOnlySpan<Object>) | |
Join(String, IEnumerable<String>) |
Verkettet die Member einer erstellten IEnumerable<T>-Auflistung vom Typ String und verwendet das angegebene Trennzeichen zwischen den einzelnen Membern. |
Join(Char, Object[]) |
Verwendet die Zeichenfolgendarstellungen eines Objektarrays mithilfe der angegebenen Trennlinie zwischen den einzelnen Elementen. |
Join(String, Object[]) |
Verkettet die Elemente eines Objektarrays und verwendet das angegebene Trennzeichen zwischen den einzelnen Elementen. |
Join(Char, ReadOnlySpan<String>) | |
Join(Char, String[]) |
Verkettet ein Zeichenfolgenarray mithilfe der angegebenen Trennlinie zwischen den einzelnen Elementen. |
Join<T>(Char, IEnumerable<T>) |
Verkettet die Member einer Auflistung und verwendet das angegebene Trennzeichen zwischen den einzelnen Membern. |
Join<T>(String, IEnumerable<T>) |
Verkettet die Member einer Auflistung und verwendet das angegebene Trennzeichen zwischen den einzelnen Membern. |
Join(String, String[])
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verkettet alle Elemente eines Zeichenfolgenarrays und verwendet das angegebene Trennzeichen zwischen den einzelnen Elementen.
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
Parameter
- separator
- String
Die Zeichenfolge, die als Trennzeichen verwendet werden soll. separator
ist in der zurückgegebenen Zeichenfolge nur enthalten, wenn value
mehr als ein Element enthält.
- value
- String[]
Ein Array, das die zu verkettenden Elemente enthält.
Gibt zurück
Eine Zeichenfolge, die aus den Membern von value
besteht, getrennt durch die separator
-Zeichenfolge.
- oder -
Empty, wenn values
0 (null) Elemente aufweist.
Ausnahmen
value
ist null
.
Die Länge der resultierenden Zeichenfolge überschreitet die maximal zulässige Länge (Int32.MaxValue).
Beispiele
Das folgende Beispiel veranschaulicht die Join Methode.
using namespace System;
String^ MakeLine( int initVal, int multVal, String^ sep )
{
array<String^>^sArr = gcnew array<String^>(10);
for ( int i = initVal; i < initVal + 10; i++ )
sArr[ i - initVal ] = String::Format( "{0, -3}", i * multVal );
return String::Join( sep, sArr );
}
int main()
{
Console::WriteLine( MakeLine( 0, 5, ", " ) );
Console::WriteLine( MakeLine( 1, 6, " " ) );
Console::WriteLine( MakeLine( 9, 9, ": " ) );
Console::WriteLine( 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
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
Hinweise
Wenn z. B. separator
", " ist und die Elemente von value
"Apfel", "Orange", "Traube" und "Birne" sind, Join(separator, value)
gibt "Apfel, Orange, Traube, Birne" zurück.
Wenn separator
ist null
, wird stattdessen eine leere Zeichenfolge (String.Empty) verwendet. Wenn ein Element in value
ist null
, wird stattdessen eine leere Zeichenfolge verwendet.
Weitere Informationen
Gilt für:
Join(String, ReadOnlySpan<String>)
public:
static System::String ^ Join(System::String ^ separator, ReadOnlySpan<System::String ^> value);
public static string Join (string? separator, ReadOnlySpan<string?> value);
static member Join : string * ReadOnlySpan<string> -> string
Public Shared Function Join (separator As String, value As ReadOnlySpan(Of String)) As String
Parameter
- separator
- String
- value
- ReadOnlySpan<String>
Gibt zurück
Gilt für:
Join(String, String[], Int32, Int32)
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verkettet die angegebenen Elemente eines Zeichenfolgenarrays und verwendet das angegebene Trennzeichen zwischen den einzelnen Elementen.
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
Parameter
- separator
- String
Die Zeichenfolge, die als Trennzeichen verwendet werden soll. separator
ist in der zurückgegebenen Zeichenfolge nur enthalten, wenn value
mehr als ein Element enthält.
- value
- String[]
Ein Array, das die zu verkettenden Elemente enthält.
- startIndex
- Int32
Das erste zu verwendende Element aus value
.
- count
- Int32
Die Anzahl der zu verwendenden Elemente aus value
.
Gibt zurück
Eine Zeichenfolge, die ab startIndex
aus den count
-Elementen von value
besteht, getrennt durch das Zeichen separator
.
- oder -
Empty, wenn count
0 (null) ist.
Ausnahmen
value
ist null
.
startIndex
oder count
ist kleiner als 0 (null).
- oder -
startIndex
plus count
ist größer als die Anzahl von Elementen in value
.
Nicht genügend Arbeitsspeicher.
Beispiele
Im folgenden Beispiel werden zwei Elemente aus einem Array von Obstnamen verkettet.
// Sample for String::Join(String, String[], int int)
using namespace System;
int main()
{
array<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'
*/
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'
Hinweise
Wenn z. B. separator
", " ist und die Elemente von value
"Apfel", "Orange", "Traube" und "Birne" sind, Join(separator, value, 1, 2)
gibt "Orange, Traube" zurück.
Wenn separator
ist null
, wird stattdessen eine leere Zeichenfolge (String.Empty) verwendet. Wenn ein Element in value
ist null
, wird stattdessen eine leere Zeichenfolge verwendet.
Weitere Informationen
Gilt für:
Join(Char, String[], Int32, Int32)
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verkettet ein Zeichenfolgenarray mithilfe der angegebenen Trennlinie zwischen den einzelnen Elementen. Dabei beginnt das Array mit dem Element in value
an der Position startIndex
, und verkettet bis zu count
Elemente.
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
Parameter
- separator
- Char
Verkettet ein Zeichenfolgenarray mithilfe der angegebenen Trennlinie zwischen den einzelnen Elementen. Dabei beginnt das Array mit dem Element, das sich am angegebenen Index befindet, und enthält eine bestimmte Anzahl von Elementen.
- value
- String[]
Ein Array von zu verkettenden Zeichenfolgen.
- startIndex
- Int32
Das erste zu verkettende Element in value
.
- count
- Int32
Die Anzahl der Elemente aus value
, die verkettet werden sollen, beginnend mit dem Element in der Position startIndex
.
Gibt zurück
Eine Zeichenfolge, die ab startIndex
aus den count
-Elementen von value
besteht, getrennt durch das Zeichen separator
.
- oder -
Empty, wenn count
0 (null) ist.
Ausnahmen
value
ist null
.
startIndex
oder count
ist negativ.
- oder -
startIndex
ist größer als die Länge von value
- count
.
Die Länge der resultierenden Zeichenfolge überschreitet die maximal zulässige Länge (Int32.MaxValue).
Gilt für:
Join(String, ReadOnlySpan<Object>)
public:
static System::String ^ Join(System::String ^ separator, ReadOnlySpan<System::Object ^> values);
public static string Join (string? separator, ReadOnlySpan<object?> values);
static member Join : string * ReadOnlySpan<obj> -> string
Public Shared Function Join (separator As String, values As ReadOnlySpan(Of Object)) As String
Parameter
- separator
- String
- values
- ReadOnlySpan<Object>
Gibt zurück
Gilt für:
Join(Char, ReadOnlySpan<Object>)
public:
static System::String ^ Join(char separator, ReadOnlySpan<System::Object ^> values);
public static string Join (char separator, ReadOnlySpan<object?> values);
static member Join : char * ReadOnlySpan<obj> -> string
Public Shared Function Join (separator As Char, values As ReadOnlySpan(Of Object)) As String
Parameter
- separator
- Char
- values
- ReadOnlySpan<Object>
Gibt zurück
Gilt für:
Join(String, IEnumerable<String>)
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verkettet die Member einer erstellten IEnumerable<T>-Auflistung vom Typ String und verwendet das angegebene Trennzeichen zwischen den einzelnen Membern.
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
Parameter
- separator
- String
Die Zeichenfolge, die als Trennzeichen verwendet werden soll.separator
ist in der zurückgegebenen Zeichenfolge nur enthalten, wenn values
mehr als ein Element enthält.
- values
- IEnumerable<String>
Eine Auflistung, die die zu verkettenden Zeichenfolgen enthält.
Gibt zurück
Eine Zeichenfolge, die aus den Membern von values
besteht, getrennt durch die separator
-Zeichenfolge.
- oder -
Empty, wenn values
0 (null) Elemente aufweist.
- Attribute
Ausnahmen
values
ist null
.
Die Länge der resultierenden Zeichenfolge überschreitet die maximal zulässige Länge (Int32.MaxValue).
Beispiele
Im folgenden Beispiel wird der Eratosthenes-Algorithmus verwendet, um die Primzahlen zu berechnen, die kleiner oder gleich 100 sind. Das Ergebnis wird einem List<T> Objekt vom Typ Stringzugewiesen, das dann an die Join(String, IEnumerable<String>) -Methode übergeben wird.
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
Hinweise
Wenn separator
ist null
, wird stattdessen eine leere Zeichenfolge (String.Empty) verwendet. Wenn ein Member von values
ist null
, wird stattdessen eine leere Zeichenfolge verwendet.
Join(String, IEnumerable<String>) ist eine praktische Methode, mit der Sie jedes Element in einer IEnumerable(Of String)
Auflistung verketten können, ohne die Elemente zuerst in ein Zeichenfolgenarray zu konvertieren. Dies ist besonders bei LINQ-Abfrageausdrücken (Language-Integrated Query) nützlich. Im folgenden Beispiel wird ein List(Of String)
-Objekt, das die Groß- oder Kleinbuchstaben des Alphabets enthält, an einen Lambdaausdruck übergeben, der Buchstaben auswählt, die gleich oder größer als ein bestimmter Buchstabe sind (der im Beispiel "M" ist). Die IEnumerable(Of String)
von der Enumerable.Where -Methode zurückgegebene Auflistung wird an die Join(String, IEnumerable<String>) -Methode übergeben, um das Ergebnis als einzelne Zeichenfolge anzuzeigen.
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
Weitere Informationen
Gilt für:
Join(Char, Object[])
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verwendet die Zeichenfolgendarstellungen eines Objektarrays mithilfe der angegebenen Trennlinie zwischen den einzelnen Elementen.
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
Parameter
- separator
- Char
Das als Trennlinie zu verwendende Zeichen. separator
ist in der zurückgegebenen Zeichenfolge nur enthalten, wenn value
mehr als ein Element enthält.
- values
- Object[]
Ein Objektarray, dessen Zeichenfolgendarstellungen verkettet werden.
Gibt zurück
Eine Zeichenfolge, die aus den Elementen von values
besteht, getrennt durch das Zeichen separator
.
- oder -
Empty, wenn values
0 (null) Elemente aufweist.
Ausnahmen
value
ist null
Die Länge der resultierenden Zeichenfolge überschreitet die maximal zulässige Länge (Int32.MaxValue).
Gilt für:
Join(String, Object[])
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verkettet die Elemente eines Objektarrays und verwendet das angegebene Trennzeichen zwischen den einzelnen Elementen.
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
Parameter
- separator
- String
Die Zeichenfolge, die als Trennzeichen verwendet werden soll. separator
ist in der zurückgegebenen Zeichenfolge nur enthalten, wenn values
mehr als ein Element enthält.
- values
- Object[]
Ein Array, das die zu verkettenden Elemente enthält.
Gibt zurück
Eine Zeichenfolge, die aus den Membern von values
besteht, getrennt durch die separator
-Zeichenfolge.
- oder -
Empty, wenn values
0 (null) Elemente aufweist.
- oder -
Nur .NET Framework: Empty, wenn das erste Element von values
null
ist.
- Attribute
Ausnahmen
values
ist null
.
Die Länge der resultierenden Zeichenfolge überschreitet die maximal zulässige Länge (Int32.MaxValue).
Beispiele
Im folgenden Beispiel wird der Eratosthenes-Algorithmus verwendet, um die Primzahlen zu berechnen, die kleiner oder gleich 100 sind. Das Ergebnis wird einem ganzzahligen Array zugewiesen, das dann an die Join(String, Object[]) -Methode übergeben wird.
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
Hinweise
null
Wenn separator
oder wenn ein anderes Element als values
das erste Element ist, wird null
stattdessen eine leere Zeichenfolge (String.Empty) verwendet. Wenn das erste Element von values
ist null
, lesen Sie den Abschnitt Notizen für Aufrufer.
Join(String, Object[]) ist eine Komfortmethode, mit der Sie jedes Element in einem Objektarray verketten können, ohne seine Elemente explizit in Zeichenfolgen zu konvertieren. Die Zeichenfolgendarstellung jedes Objekts im Array wird durch Aufrufen der Methode dieses ToString
Objekts abgeleitet.
Hinweise für Aufrufer
nur .NET Framework: Wenn das erste Element von values
ist, verkettet null
die Join(String, Object[]) -Methode nicht die Elemente invalues
, sondern gibt stattdessen zurückEmpty. Es stehen eine Reihe von Problemumgehungen für dieses Problem zur Verfügung. Am einfachsten ist es, dem ersten Element des Arrays einen Wert von Empty zuzuweisen, wie im folgenden Beispiel gezeigt.
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
Weitere Informationen
Gilt für:
Join(Char, ReadOnlySpan<String>)
public:
static System::String ^ Join(char separator, ReadOnlySpan<System::String ^> value);
public static string Join (char separator, ReadOnlySpan<string?> value);
static member Join : char * ReadOnlySpan<string> -> string
Public Shared Function Join (separator As Char, value As ReadOnlySpan(Of String)) As String
Parameter
- separator
- Char
- value
- ReadOnlySpan<String>
Gibt zurück
Gilt für:
Join(Char, String[])
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verkettet ein Zeichenfolgenarray mithilfe der angegebenen Trennlinie zwischen den einzelnen Elementen.
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
Parameter
- separator
- Char
Das als Trennlinie zu verwendende Zeichen. separator
ist in der zurückgegebenen Zeichenfolge nur enthalten, wenn value
mehr als ein Element enthält.
- value
- String[]
Ein Array von zu verkettenden Zeichenfolgen.
Gibt zurück
Eine Zeichenfolge, die aus den Elementen von value
besteht, getrennt durch das Zeichen separator
.
- oder -
Empty, wenn value
0 (null) Elemente aufweist.
Ausnahmen
value
ist null
Die Länge der resultierenden Zeichenfolge überläuft die maximal zulässige Länge (Int32.MaxValue).
Gilt für:
Join<T>(Char, IEnumerable<T>)
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verkettet die Member einer Auflistung und verwendet das angegebene Trennzeichen zwischen den einzelnen Membern.
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
Typparameter
- T
Der Typ der Member von values
.
Parameter
- separator
- Char
Das als Trennlinie zu verwendende Zeichen. separator
ist in der zurückgegebenen Zeichenfolge nur enthalten, wenn values
mehr als ein Element enthält.
- values
- IEnumerable<T>
Eine Auflistung, die die zu verkettenden Objekte enthält.
Gibt zurück
Eine Zeichenfolge, die aus den Elementen von values
besteht, getrennt durch das Zeichen separator
.
- oder -
Empty, wenn values
keine Elemente aufweist.
Ausnahmen
values
ist null
Die Länge der resultierenden Zeichenfolge überläuft die maximal zulässige Länge (Int32.MaxValue).
Gilt für:
Join<T>(String, IEnumerable<T>)
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
- Quelle:
- String.Manipulation.cs
Verkettet die Member einer Auflistung und verwendet das angegebene Trennzeichen zwischen den einzelnen Membern.
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
Typparameter
- T
Der Typ der Member von values
.
Parameter
- separator
- String
Die Zeichenfolge, die als Trennzeichen verwendet werden soll. separator
ist in der zurückgegebenen Zeichenfolge nur enthalten, wenn values
mehr als ein Element enthält.
- values
- IEnumerable<T>
Eine Auflistung, die die zu verkettenden Objekte enthält.
Gibt zurück
Eine Zeichenfolge, die aus den Membern von values
besteht, getrennt durch die separator
-Zeichenfolge.
- oder -
Empty, wenn values
keine Elemente aufweist.
- Attribute
Ausnahmen
values
ist null
.
Die Länge der resultierenden Zeichenfolge überläuft die maximal zulässige Länge (Int32.MaxValue).
Beispiele
Im folgenden Beispiel wird der Algorithmus Sieve of Eratosthenes verwendet, um die Primzahlen zu berechnen, die kleiner als oder gleich 100 sind. Das Ergebnis wird einem List<T> Objekt vom Typ Integer zugewiesen, das dann an die Join<T>(String, IEnumerable<T>) -Methode übergeben wird.
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
Hinweise
Wenn separator
ist null
, wird stattdessen eine leere Zeichenfolge (String.Empty) verwendet. Wenn ein Element von values
ist null
, wird stattdessen eine leere Zeichenfolge verwendet.
Join<T>(String, IEnumerable<T>) ist eine Komfortmethode, mit der Sie jedes Element einer IEnumerable<T> Auflistung verketten können, ohne sie zuvor in Zeichenfolgen zu konvertieren. Die Zeichenfolgendarstellung jedes Objekts in der Auflistung wird durch Aufrufen der IEnumerable<T> Methode dieses ToString
Objekts abgeleitet.
Diese Methode ist besonders nützlich bei Language-Integrated Query (LINQ)-Abfrageausdrücken. Der folgende Code definiert beispielsweise eine sehr einfache Animal
Klasse, die den Namen eines Tieres und die Reihenfolge enthält, zu der es gehört. Anschließend wird ein List<T> -Objekt definiert, das eine Reihe von Animal
Objekten enthält. Die Enumerable.Where Erweiterungsmethode wird aufgerufen, um die Animal
Objekte zu extrahieren, deren Order
Eigenschaft "Rodent" entspricht. Das Ergebnis wird an die Join<T>(String, IEnumerable<T>) -Methode übergeben.
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
Weitere Informationen
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für