Join-Funktion (Visual Basic)
Aktualisiert: November 2007
Gibt eine Zeichenfolge zurück, die durch Verknüpfen mehrerer Teilzeichenfolgen aus einem Array erstellt wurde.
Function Join(
ByVal SourceArray() As { Object | String },
Optional ByVal Delimiter As String = " "
) As String
Parameter
SourceArray
Erforderlich. Eindimensionales Array, das die zu kombinierenden Teilzeichenfolgen enthält.Delimiter
Optional. Zeichenfolge, mit der die Teilzeichenfolgen in der zurückgegebenen Zeichenfolge getrennt werden. Ohne Angabe wird das Leerzeichen (" ") verwendet. Wenn Delimiter eine Zeichenfolge mit der Länge 0 (null, "") oder Nothing ist, werden alle Elemente in der Liste ohne Trennzeichen verkettet.
Ausnahmen
Ausnahmetyp |
Fehlernummer |
Bedingung |
|---|---|---|
SourceArray ist nicht eindimensional. |
Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.
Hinweise
In einer Hinsicht sind die Join-Funktion und die Split-Funktion gleichwertig. Die Join-Funktion verknüpft die Zeichenfolgen in einem Zeichenfolgenarray mit einer Trennzeichenfolge, und gibt eine einzige Zeichenfolge zurück. Die Split-Funktion trennt eine Zeichenfolge am Trennzeichen, und gibt ein Zeichenfolgenarray zurück. Der Hauptunterschied besteht jedoch darin, dass Join Zeichenfolgen mit beliebigen Trennzeichenfolgen verketten kann, während Split nur Zeichenfolgen mit einem einzigen Trennzeichen trennen kann.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie mithilfe der Join-Funktion aus mehreren Zeichenfolgen eine Liste erstellt wird.
Dim TestItem() As String = {"Pickle", "Pineapple", "Papaya"}
' Returns "Pickle, Pineapple, Papaya"
Dim TestShoppingList As String = Join(TestItem, ", ")
Anforderungen
Namespace:Microsoft.VisualBasic
**Modul:**Strings
**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)