String.Join Metódus

Definíció

Összefűzi egy adott tömb vagy gyűjtemény tagjai elemeit az egyes elemek vagy tagok között megadott elválasztó használatával.

Túlterhelések

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

Összefűzi egy sztringtömb megadott elemeit a megadott elválasztójellel az egyes elemek között.

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

Összefűz egy sztringtömböt a megadott elválasztójellel az egyes tagok között, kezdve a pozícióban lévő valuestartIndex elemmel, és összefűzi az count elemeket.

Join(String, String[])

Összefűzi egy sztringtömb összes elemét az egyes elemek között megadott elválasztójellel.

Join(String, ReadOnlySpan<String>)

Sztringek egy részét összefűzi az egyes tagok között megadott elválasztójellel.

Join(String, ReadOnlySpan<Object>)

Összefűzi az objektumok egy-egy halmazának sztring-ábrázolását az egyes tagok között megadott elválasztójellel.

Join(Char, ReadOnlySpan<String>)

Sztringek egy részét összefűzi az egyes tagok között megadott elválasztójellel.

Join(String, IEnumerable<String>)

Összefűzi egy létrehozott IEnumerable<T> típusú Stringgyűjtemény tagjait az egyes tagok között megadott elválasztójellel.

Join(Char, String[])

Sztringek tömbjének összefűzése az egyes tagok között megadott elválasztójellel.

Join(String, Object[])

Összefűzi egy objektumtömb elemeit a megadott elválasztójellel az egyes elemek között.

Join(Char, ReadOnlySpan<Object>)

Összefűzi az objektumok egy-egy halmazának sztring-ábrázolását az egyes tagok között megadott elválasztójellel.

Join(Char, Object[])

Összefűzi egy objektumtömb sztringreprezentációit a megadott elválasztójellel az egyes tagok között.

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

Összefűzi a gyűjtemény tagjait a megadott elválasztójellel az egyes tagok között.

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

Összefűzi a gyűjtemény tagjait a megadott elválasztójellel az egyes tagok között.

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

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi egy sztringtömb megadott elemeit a megadott elválasztójellel az egyes elemek között.

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

Paraméterek

separator
String

Az elválasztóként használni kívánt sztring. separator csak akkor szerepel a visszaadott sztringben, ha value több elemből áll.

value
String[]

Az összefűzendő elemeket tartalmazó tömb.

startIndex
Int32

A használat első eleme value .

count
Int32

A használandó elemek value száma.

Válaszok

Olyan sztring, amely a karakter által count tagolt kezdő value elemekből startIndex állseparator.

-vagy-

Empty ha count nulla.

Kivételek

value az null.

startIndex vagy count kisebb, mint 0.

-vagy-

startIndexplusz count nagyobb, mint az elemek száma.value

Nincs memóriája.

Példák

Az alábbi példa két elemet fűz össze egy gyümölcsnévtömbből.

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'

Megjegyzések

Ha például separator ", " és az elemek az "apple", "orange", "grape" és "körte", value akkor a "narancs, szőlő" értéket Join(separator, value, 1, 2) adja vissza.

Ha separator igen null, akkor ehelyett egy üres sztringet (String.Empty) használ a rendszer. Ha valamelyik elem benne value van null, a rendszer ehelyett egy üres sztringet használ.

Lásd még

A következőre érvényes:

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

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűz egy sztringtömböt a megadott elválasztójellel az egyes tagok között, kezdve a pozícióban lévő valuestartIndex elemmel, és összefűzi az count elemeket.

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

Paraméterek

separator
Char

Összefűz egy sztringtömböt a megadott elválasztójellel az egyes tagok között, kezdve a megadott indexben található elemmel, és adott számú elemet is tartalmaz.

value
String[]

Összefűzendő sztringek tömbje.

startIndex
Int32

Az első összefűzendő elem value .

count
Int32

Az elemek value száma a pozícióban lévő startIndex elemtől kezdve az összefűzésig.

Válaszok

Olyan sztring, amely a karakter által count tagolt kezdő value elemekből startIndex állseparator.

-vagy-

Empty ha count nulla.

Kivételek

value az null.

startIndex vagy count negatívak.

-vagy-

startIndex nagyobb, mint a hossza value - count.

Az eredményül kapott sztring hossza túllépi a megengedett maximális hosszt (Int32.MaxValue).

A következőre érvényes:

Join(String, String[])

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi egy sztringtömb összes elemét az egyes elemek között megadott elválasztójellel.

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

Paraméterek

separator
String

Az elválasztóként használni kívánt sztring. separator csak akkor szerepel a visszaadott sztringben, ha value több elemből áll.

value
String[]

Az összefűzendő elemeket tartalmazó tömb.

Válaszok

Egy sztring, amely a sztring által value tagolt elemekből separator áll.

-vagy-

Empty ha value nulla elemekkel rendelkezik.

Kivételek

value az null.

Az eredményül kapott sztring hossza túllépi a megengedett maximális hosszt (Int32.MaxValue).

Példák

Az alábbi példa a metódust Join mutatja be.

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

Megjegyzések

Ha például separator ", " és az elemek value az "apple", "orange", "grape", és "körte", Join(separator, value) akkor az "alma, narancs, szőlő, körte" értéket adja vissza.

Ha separator igen null, akkor ehelyett egy üres sztringet (String.Empty) használ a rendszer. Ha valamelyik elem benne value van null, a rendszer ehelyett egy üres sztringet használ.

Lásd még

A következőre érvényes:

Join(String, ReadOnlySpan<String>)

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Sztringek egy részét összefűzi az egyes tagok között megadott elválasztójellel.

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

Paraméterek

separator
String

Az elválasztóként használni kívánt sztring. separator csak akkor szerepel a visszaadott sztringben, ha value több elemből áll.

value
ReadOnlySpan<String>

Az összefűzendő elemeket tartalmazó span.

Válaszok

A sztring által tagolt elemekből value álló sztring separator . -vagy- Empty ha value nulla elemből áll.

A következőre érvényes:

Join(String, ReadOnlySpan<Object>)

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi az objektumok egy-egy halmazának sztring-ábrázolását az egyes tagok között megadott elválasztójellel.

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

Paraméterek

separator
String

Az elválasztóként használni kívánt sztring. separator csak akkor szerepel a visszaadott sztringben, ha values több elemből áll.

values
ReadOnlySpan<Object>

Olyan objektumok spanja, amelyek sztringreprezentációit összefűzi a rendszer.

Válaszok

A sztring által tagolt elemekből values álló sztring separator . -vagy- Empty ha values nulla elemből áll.

A következőre érvényes:

Join(Char, ReadOnlySpan<String>)

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Sztringek egy részét összefűzi az egyes tagok között megadott elválasztójellel.

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

Paraméterek

separator
Char

Az elválasztóként használandó karakter. separator csak akkor szerepel a visszaadott sztringben, ha value több elemből áll.

value
ReadOnlySpan<String>

Az összefűzendő elemeket tartalmazó span.

Válaszok

A sztring által tagolt elemekből value álló sztring separator . -vagy- Empty ha value nulla elemből áll.

A következőre érvényes:

Join(String, IEnumerable<String>)

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi egy létrehozott IEnumerable<T> típusú Stringgyűjtemény tagjait az egyes tagok között megadott elválasztójellel.

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

Paraméterek

separator
String

Az elválasztóként használni kívánt sztring. separator csak akkor szerepel a visszaadott sztringben, ha values több elemből áll.

values
IEnumerable<String>

Az összefűzendő sztringeket tartalmazó gyűjtemény.

Válaszok

A sztring által tagolt elemekből values álló sztring separator .

-vagy-

Empty ha values nulla elemekkel rendelkezik.

Attribútumok

Kivételek

values az null.

Az eredményül kapott sztring hossza túllépi a megengedett maximális hosszt (Int32.MaxValue).

Példák

Az alábbi példa az Eratosthenes-algoritmus szitát használja a 100-nál kisebb vagy egyenlő prímszámok kiszámításához. Az eredményt egy List<T> olyan típusú Stringobjektumhoz rendeli, amelyet aztán átad a Join(String, IEnumerable<String>) metódusnak.

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

Megjegyzések

Ha separator igen null, akkor ehelyett egy üres sztringet (String.Empty) használ a rendszer. Ha valamelyik tagja values , nullakkor ehelyett egy üres sztringet használ.

Join(String, IEnumerable<String>) egy egyszerű módszer, amellyel a gyűjtemény minden elemét IEnumerable(Of String) összefűzheti anélkül, hogy először sztringtömböt alakítanának át az elemekre. Különösen hasznos Language-Integrated Lekérdezés (LINQ) lekérdezési kifejezések esetében. Az alábbi példa egy List(Of String) olyan objektumot ad át, amely az ábécé nagybetűit vagy kisbetűit tartalmazza egy lambda kifejezésnek, amely egy adott betűvel egyenlő vagy annál nagyobb betűket választ ki (amely a példában "M"). A IEnumerable(Of String) metódus által Enumerable.Where visszaadott gyűjteményt a metódus átadja az Join(String, IEnumerable<String>) eredmény egyetlen sztringként való megjelenítéséhez.

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

Lásd még

A következőre érvényes:

Join(Char, String[])

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Sztringek tömbjének összefűzése az egyes tagok között megadott elválasztójellel.

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

Paraméterek

separator
Char

Az elválasztóként használandó karakter. separator csak akkor szerepel a visszaadott sztringben, ha value több elemből áll.

value
String[]

Összefűzendő sztringek tömbje.

Válaszok

A karakter által value tagolt elemekből separator álló sztring.

-vagy-

Empty ha value nulla elemekkel rendelkezik.

Kivételek

value az null.

Az eredményül kapott sztring hossza túllépi a megengedett maximális hosszt (Int32.MaxValue).

A következőre érvényes:

Join(String, Object[])

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi egy objektumtömb elemeit a megadott elválasztójellel az egyes elemek között.

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

Paraméterek

separator
String

Az elválasztóként használni kívánt sztring. separator csak akkor szerepel a visszaadott sztringben, ha values több elemből áll.

values
Object[]

Az összefűzendő elemeket tartalmazó tömb.

Válaszok

A sztring által tagolt elemekből values álló sztring separator .

-vagy-

Empty ha values nulla elemekkel rendelkezik.

-vagy-

csak .NET keretrendszer: Empty, ha a values első eleme null.

Attribútumok

Kivételek

values az null.

Az eredményül kapott sztring hossza túllépi a megengedett maximális hosszt (Int32.MaxValue).

Példák

Az alábbi példa az Eratosthenes-algoritmus szitát használja a 100-nál kisebb vagy egyenlő prímszámok kiszámításához. Az eredményt egy egész számtömbhöz rendeli, amelyet aztán átad a Join(String, Object[]) metódusnak.

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

Megjegyzések

Ha separator az null első elemen valueskívül más elem null is, akkor helyette üres sztringet (String.Empty) használ a rendszer. Ha az első elem az , tekintse meg a Hívók megjegyzései szakaszt valuesnull.

Join(String, Object[]) egy egyszerű módszer, amellyel összefűzheti egy objektumtömb minden elemét anélkül, hogy az elemeit sztringekké alakítanák. A tömb minden objektumának sztring-ábrázolása az objektum metódusának ToString meghívásával származtatható.

Megjegyzések a hívókhoz

csak .NET keretrendszer: Ha a values első eleme null, akkor a Join(String, Object[]) metódus nem fűzi össze a values elemeit, hanem Empty ad vissza. Ehhez a problémához számos áthidaló megoldás érhető el. A legegyszerűbb, ha a tömb első eleméhez Empty rendel egy értéket, ahogy az az alábbi példában is látható.

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

Lásd még

A következőre érvényes:

Join(Char, ReadOnlySpan<Object>)

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi az objektumok egy-egy halmazának sztring-ábrázolását az egyes tagok között megadott elválasztójellel.

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

Paraméterek

separator
Char

Az elválasztóként használandó karakter. separator csak akkor szerepel a visszaadott sztringben, ha az érték több elemet tartalmaz.

values
ReadOnlySpan<Object>

Olyan objektumok spanja, amelyek sztringreprezentációit összefűzi a rendszer.

Válaszok

A karakter által values tagolt elemekből separator álló sztring. -vagy- Empty ha values nulla elemből áll.

A következőre érvényes:

Join(Char, Object[])

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi egy objektumtömb sztringreprezentációit a megadott elválasztójellel az egyes tagok között.

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

Paraméterek

separator
Char

Az elválasztóként használandó karakter. separator csak akkor szerepel a visszaadott sztringben, ha values több elemből áll.

values
Object[]

Olyan objektumok tömbje, amelyek sztringreprezentációit összefűzi a rendszer.

Válaszok

A karakter által values tagolt elemekből separator álló sztring.

-vagy-

Empty ha values nulla elemekkel rendelkezik.

Kivételek

values az null.

Az eredményül kapott sztring hossza túllépi a megengedett maximális hosszt (Int32.MaxValue).

A következőre érvényes:

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

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi a gyűjtemény tagjait a megadott elválasztójellel az egyes tagok között.

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ípusparaméterek

T

A tagok valuestípusa.

Paraméterek

separator
Char

Az elválasztóként használandó karakter. separator csak akkor szerepel a visszaadott sztringben, ha values több elemből áll.

values
IEnumerable<T>

Az összefűzendő objektumokat tartalmazó gyűjtemény.

Válaszok

A karakter által values tagolt tagokból separator álló sztring.

-vagy-

Empty ha values nincsenek elemei.

Kivételek

values az null.

Az eredményül kapott sztring hossza túllépi a megengedett maximális hosszt (Int32.MaxValue).

A következőre érvényes:

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

Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs
Forrás:
String.Manipulation.cs

Összefűzi a gyűjtemény tagjait a megadott elválasztójellel az egyes tagok között.

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ípusparaméterek

T

A tagok valuestípusa.

Paraméterek

separator
String

Az elválasztóként használni kívánt sztring. separator csak akkor szerepel a visszaadott sztringben, ha values több elemből áll.

values
IEnumerable<T>

Az összefűzendő objektumokat tartalmazó gyűjtemény.

Válaszok

A sztring által tagolt elemekből values álló sztring separator .

-vagy-

Empty ha values nincsenek elemei.

Attribútumok

Kivételek

values az null.

Az eredményül kapott sztring hossza túllépi a megengedett maximális hosszt (Int32.MaxValue).

Példák

Az alábbi példa az Eratosthenes-algoritmus szitát használja a 100-nál kisebb vagy egyenlő prímszámok kiszámításához. Az eredményt egy List<T> egész típusú objektumhoz rendeli, amelyet aztán átad a Join<T>(String, IEnumerable<T>) metódusnak.

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

Megjegyzések

Ha separator igen null, akkor ehelyett egy üres sztringet (String.Empty) használ a rendszer. Ha valamelyik tagja values , nullakkor ehelyett egy üres sztringet használ.

Join<T>(String, IEnumerable<T>) egy egyszerű módszer, amellyel a gyűjtemény minden tagját összefűzheti anélkül, hogy sztringekké IEnumerable<T> alakítanák őket. A gyűjtemény egyes objektumainak sztringképe az IEnumerable<T> objektum metódusának ToString meghívásával származtatható.

Ez a módszer különösen hasznos Language-Integrated Lekérdezés (LINQ) lekérdezési kifejezések esetében. A következő kód például egy nagyon egyszerű Animal osztályt határoz meg, amely tartalmazza az állat nevét és annak sorrendjét. Ezután definiál egy List<T> objektumot, amely több Animal objektumot tartalmaz. A Enumerable.Where bővítménymetódus azoknak az objektumoknak a Animal kinyerésére van meghívva, amelyek Order tulajdonsága "Rágcsáló". Az eredmény a metódusnak lesz átadva 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

Lásd még

A következőre érvényes: