about_Join
Krótki opis
Opisuje, w jaki sposób operator sprzężenia (-join) łączy wiele ciągów w jeden ciąg.
Długi opis
Operator sprzężenia łączy zestaw ciągów w jeden ciąg. Ciągi są dołączane do wynikowego ciągu w kolejności, w której są wyświetlane w poleceniu.
Składnia
Na poniższym diagramie przedstawiono składnię operatora sprzężenia.
-Join <String[]>
<String[]> -Join <Delimiter>
Parametry
String[] — określa co najmniej jeden ciąg do sprzężenia.
Ogranicznik — określa jeden lub więcej znaków umieszczonych między połączonymi ciągami. Wartość domyślna to żaden ogranicznik ("").
Uwagi
Operator sprzężenia jednoargumentowego (-join <string[]>) ma wyższy priorytet niż przecinek. W związku z tym, jeśli prześlesz rozdzielaną przecinkami listę ciągów do operatora jednoargumentowego sprzężenia, tylko pierwszy ciąg (przed pierwszym przecinkiem) zostanie przesłany do operatora sprzężenia.
Aby użyć operatora jednoargumentowego sprzężenia, należy ująć ciągi w nawiasy lub zapisać ciągi w zmiennej, a następnie przesłać zmienną do sprzężenia.
Na przykład:
-join "a", "b", "c"
a
b
c
-join ("a", "b", "c")
abc
$z = "a", "b", "c"
-join $z
abc
Przykłady
Następująca instrukcja łączy trzy ciągi:
-join ("Windows", "PowerShell", "2.0")
WindowsPowerShell2.0
Następująca instrukcja łączy trzy ciągi rozdzielone spacją:
"Windows", "PowerShell", "2.0" -join " "
Windows PowerShell 2.0
Następujące instrukcje używają ogranicznika wieloznakowego do łączenia trzech ciągów:
$a = "WIND", "S P", "ERSHELL"
$a -join "OW"
WINDOWS POWERSHELL
Poniższa instrukcja łączy wiersze w poniższym ciągu w jeden ciąg. Ponieważ ciąg here-string jest jednym ciągiem, przed ich sprzężeniami wiersze w ciągu tutaj muszą zostać podzielone. Tej metody można użyć do ponownego dołączania ciągów w pliku XML, który został zapisany w następującym ciągu:
$a = @'
a
b
c
'@
(-split $a) -join " "
a b c