Join 函式 (Visual Basic)

更新:2007 年 11 月

傳回結合包含在陣列中幾個子字串所建立的字串。

Function Join(
   ByVal SourceArray() As { Object | String },
   Optional ByVal Delimiter As String = " "
) As String

參數

  • SourceArray
    必要項。一維陣列中包含了要聯結的子字串。

  • Delimiter
    選擇項。任何字串,用來分隔傳回字串中的子字串。如果省略,則會使用空白字元 (" ")。如果 Delimiter 是長度為零的字串 ("") 或 Nothing,則不會使用分隔符號 (Delimiter) 來串連清單中的所有項目。

例外狀況

例外狀況類型

錯誤代碼

條件

ArgumentException

5

SourceArray 不是一維。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級,請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是,請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。

備註

Join 與 Split 函式之間有同位檢查。Join 函式會取得字串的陣列,並使用分隔符號字串來進行聯結 (Join),以傳回單一字串。Split 函式會取得一個字串,並在分隔符號處加以隔開,以傳回字串的陣列。不過,主要的差異在於 Join 可使用任何分隔符號字串來串連字串,而 Split 只可使用單一字元分隔符號來隔開字串。

範例

下列範例會示範如何使用 Join 函式,建立數個字串的清單。

Dim TestItem() As String = {"Pickle", "Pineapple", "Papaya"}
' Returns "Pickle, Pineapple, Papaya"
Dim TestShoppingList As String = Join(TestItem, ", ")

需求

命名空間 (Namespace)︰Microsoft.VisualBasic

模組:Strings

組件 (Assembly):Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

參考

字串操作摘要

Split 函式 (Visual Basic)

ArgumentException