Strings.Split 方法

傳回以零起始的一維陣列，其中包含指定之子字串數目。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function Split ( _
    Expression As String, _
    <OptionalAttribute> Optional Delimiter As String = " ", _
    <OptionalAttribute> Optional Limit As Integer = -1, _
    <OptionalAttribute> Optional Compare As CompareMethod = CompareMethod.Binary _
) As String()
'用途
Dim Expression As String
Dim Delimiter As String
Dim Limit As Integer
Dim Compare As CompareMethod
Dim returnValue As String()

returnValue = Strings.Split(Expression, Delimiter, Limit, Compare)

public static string[] Split (
    string Expression,
    [OptionalAttribute] string Delimiter,
    [OptionalAttribute] int Limit,
    [OptionalAttribute] CompareMethod Compare
)

public:
static array<String^>^ Split (
    String^ Expression, 
    [OptionalAttribute] String^ Delimiter, 
    [OptionalAttribute] int Limit, 
    [OptionalAttribute] CompareMethod Compare
)

public static String[] Split (
    String Expression, 
    /** @attribute OptionalAttribute() */ String Delimiter, 
    /** @attribute OptionalAttribute() */ int Limit, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

public static function Split (
    Expression : String, 
    Delimiter : String, 
    Limit : int, 
    Compare : CompareMethod
) : String[]

參數

• Expression
  必要項。String 運算式，包含子字串和分隔符號。

• Delimiter
  選擇項。用來識別子字串限制的單一字元。如果省略 Delimiter，則會假設空白字元 (" ") 為分隔符號。

• Limit
  選擇項。輸入字串應該分割之子字串數目的最大值。預設為 –1，表示應該在每次遇到 Delimiter 字串時即分割輸入字串。

• Compare
  選擇項。數值，表示在評估子字串時要使用的比較。請參閱值的「設定」。

傳回值

String 陣列。如果 Expression 是長度為零的字串 ("")，Split 會傳回包含長度為零的字串之單一元素陣列。如果 Delimiter 是長度為零的字串，或是未出現在 Expression 內的任何位置，則 Split 會傳回單一元素陣列，其中包含整個 Expression 字串。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 Split 函式 (Visual Basic)。

根據預設，當 Limit 等於 -1 時，Split 函式會在每次遇到分隔符號字串時分割輸入字串，並傳回陣列中的子字串。當 Limit 參數大於零時，Split 函式會在遇到第一個 Limit-1 的分隔符號時分割字串，並傳回陣列以及產生的子字串。例如，Split("a:b:c", ":") 會傳回陣列 {"a", "b", "c"}，而 Split("a:b:c", ":", 2) 則會傳回陣列 {"a", "b:c"}。

當 Split 函式在一個資料列中遇到兩個分隔符號，或是在字串開頭或結尾位置遇到一個分隔符號時，都會將這些分符號解譯為空白字串 ("")。例如，Split("xx", "x") 會傳回包含三個空白字串的陣列：一個來自字串開頭與第一個 "x" 之間、一個來自兩個 "x" 字串之間，而第三個則是來自最後一個 "x" 與字串結尾之間。

下表將示範選擇性的 Delimiter、Limit 和 Compare 參數要如何變更 Split 函式的行為。

分割呼叫	傳回值
Split("42, 12, 19")	{"42," , "12," , "19"}
Split("42, 12, 19", ", ")	{"42", "12", "19"}
Split("42, 12, 19", ", ", 2)	{"42", "12, 19"}
Split("192.168.0.1", ".")	{"192", "168", "0", "1"}
Split("Alice and Bob", " AND ")	{"Alice and Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text)	{"Alice", "Bob"}
Split("someone@example.com", "@",1)	{"someone@example.com"}
Split("someone@example.com", "@",2)	{"someone", "example.com"}

Compare 引數可以具有下列的值。

常數	說明	值
CompareMethod.Binary	執行二進位比較	0
CompareMethod.Text	執行文字比較	1

範例

下列範例將示範如何在其空格上分割字串。

Dim TestString As String = "Look at these!"
' Returns an array containing "Look", "at", and "these!".
Dim TestArray() As String = Split(TestString)

下列範例將示範如何在資料列中以多個分隔符號分割字串，以及篩選掉空字串。

Dim TestString As String = "apple    pear banana  "
Dim TestArray() As String = Split(TestString)
' TestArray holds {"apple", "", "", "", "pear", "banana", "", ""}
Dim LastNonEmpty As Integer = -1
For i As Integer = 0 To TestArray.Length - 1
    If TestArray(i) <> "" Then
        LastNonEmpty += 1
        TestArray(LastNonEmpty) = TestArray(i)
    End If
Next
ReDim Preserve TestArray(LastNonEmpty)
' TestArray now holds {"apple", "pear", "banana"}

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

Strings 類別
Strings 成員
Microsoft.VisualBasic 命名空間

其他資源

Split 函式 (Visual Basic)
字串操作摘要
Join 函式 (Visual Basic)
CompareMethod 列舉型別