Delimiter characters are not included in the elements of the returned array.

If this instance does not contain any of the characters in separator, the returned array consists of a single element that contains this instance.

If the separator parameter is nullNothingnullptra null reference (Nothing in Visual Basic) or contains no characters, white-space characters are assumed to be the delimiters. White-space characters are defined by the Unicode standard and return true if they are passed to the Char..::.IsWhiteSpace method.

Each element of separator defines a separate delimiter character. If two delimiters are adjacent, or a delimiter is found at the beginning or end of this instance, the corresponding array element contains Empty. The following table provides examples.

Performance Considerations

In the .NET Framework 3.5 and earlier versions, if the Split method is passed a separator that is nullNothingnullptra null reference (Nothing in Visual Basic) or contains no characters, the method uses a slightly different set of characters to split the string than the Trim method does to trim the string. In the .NET Framework 4, both methods use an identical set of Unicode white-space characters.

The following example demonstrates how to extract individual words from a block of text by treating white space and punctuation marks as delimiters. The character array passed to the separator parameter of the String..::.Split(array<Char>[]()[]) method consists of a space character and a tab character, together with some common punctuation symbols.

Public Class SplitTest
    Public Shared Sub Main()
        Dim words As String = "This is a list of words, with: a bit of punctuation" + _
                              vbTab + "and a tab character."
        Dim split As String() = words.Split(New [Char]() {" "c, ","c, "."c, ":"c, CChar(vbTab) })

        For Each s As String In  split
            If s.Trim() <> "" Then
                Console.WriteLine(s)
            End If
        Next s
    End Sub 'Main
End Class 'SplitTest
' The example displays the following output to the console:
'       This
'       is
'       a
'       list
'       of
'       words
'       with
'       a
'       bit
'       of
'       punctuation
'       and
'       a
'       tab
'       character

using System;

public class SplitTest {
    public static void Main() {

        string words = "This is a list of words, with: a bit of punctuation" +
                       "\tand a tab character.";

        string [] split = words.Split(new Char [] {' ', ',', '.', ':', '\t' });

        foreach (string s in split) {

            if (s.Trim() != "")
                Console.WriteLine(s);
        }
    }
}
// The example displays the following output to the console:
//       This
//       is
//       a
//       list
//       of
//       words
//       with
//       a
//       bit
//       of
//       punctuation
//       and
//       a
//       tab
//       character

.NET Framework

.NET Framework Client Profile

Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2

Reference

Trennzeichen sind in den Elementen des zurückgegebenen Arrays nicht enthalten.

Wenn diese Instanz keine der Zeichen in separator enthält, besteht das zurückgegebene Array aus einem einzelnen Element, das diese Instanz enthält.

Wenn der separator-Parameter nullNothingnullptrNULL-Verweis (Nothing in Visual Basic) ist oder keine Zeichen enthält, werden Leerraumzeichen als Trennzeichen angenommen. Leerstellenzeichen werden vom Unicodestandard definiert und geben true zurück, wenn sie an die Char..::.IsWhiteSpace-Methode übergeben werden.

Jedes Element von separator definiert ein separates Trennzeichen. Wenn zwei Trennzeichen aufeinander folgen oder ein Trennzeichen sich am Anfang oder Ende dieser Instanz befinden, enthält das entsprechende Arrayelement Empty. Der folgende Tabelle enthält Beispiele.

Überlegungen zur Leistung

In .NET Framework 3.5 und früheren Versionen: Wenn der Split-Methode ein separator, der nullNothingnullptrNULL-Verweis (Nothing in Visual Basic) ist oder keine Zeichen enthält, übergeben wird, verwendet die Methode einen etwas anderen Satz von Zeichen, um die Zeichenfolge zu teilen, als die Trim-Methode. In .NET Framework 4 verwenden beide Methoden einen identischen Satz von Unicode-Leerstellenzeichen.

Im folgenden Beispiel wird veranschaulicht, wie einzelne Wörter aus einem Textblock extrahiert werden, indem Leerraum und Interpunktionszeichen als Trennzeichen behandelt werden. Das an den separator-Parameter der String..::.Split(array<Char>[]()[])-Methode übergebene Zeichenarray besteht aus einem Leerzeichen und einem Tabstoppzeichen zusammen mit einigen häufig verwendeten Interpunktionszeichen.

Public Class SplitTest
    Public Shared Sub Main()
        Dim words As String = "This is a list of words, with: a bit of punctuation" + _
                              vbTab + "and a tab character."
        Dim split As String() = words.Split(New [Char]() {" "c, ","c, "."c, ":"c, CChar(vbTab) })

        For Each s As String In  split
            If s.Trim() <> "" Then
                Console.WriteLine(s)
            End If
        Next s
    End Sub 'Main
End Class 'SplitTest
' The example displays the following output to the console:
'       This
'       is
'       a
'       list
'       of
'       words
'       with
'       a
'       bit
'       of
'       punctuation
'       and
'       a
'       tab
'       character

using System;

public class SplitTest {
    public static void Main() {

        string words = "This is a list of words, with: a bit of punctuation" +
                       "\tand a tab character.";

        string [] split = words.Split(new Char [] {' ', ',', '.', ':', '\t' });

        foreach (string s in split) {

            if (s.Trim() != "")
                Console.WriteLine(s);
        }
    }
}
// The example displays the following output to the console:
//       This
//       is
//       a
//       list
//       of
//       words
//       with
//       a
//       bit
//       of
//       punctuation
//       and
//       a
//       tab
//       character

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz