String.Split Method (array<String[], StringSplitOptions)

Parameters

• separator
  Type: array<System.String[]
  An array of strings that delimits the substrings in this string, an empty array that contains no delimiters, or nulla null reference (Nothing in Visual Basic).

• options
  Type: System.StringSplitOptions
  A flag that indicates whether to include empty elements in the returned array. Specify RemoveEmptyEntries to omit empty array elements from the returned array. Specify None to include empty array elements in the returned array.

Return Value

Type: array<System.String[]
An array whose elements contain the substrings in this string that are delimited by one or more strings in separator. For more information, see the Remarks section.

Dim source As String = "[stop]ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]"
Dim stringSeparators() As String = {"[stop]"}
Dim result() As String

' Display the original string and delimiter string.
outputBlock.Text &= String.Format("Splitting the string:{0}   '{1}'.", vbCrLf, source) & vbCrLf
outputBlock.Text &= vbCrLf
outputBlock.Text &= String.Format("Using the delimiter string:{0}   '{1}'.", _
                  vbCrLf, stringSeparators(0)) & vbCrLf
outputBlock.Text &= vbCrLf

' Split a string delimited by another string and return all elements.
result = source.Split(stringSeparators, StringSplitOptions.None)
outputBlock.Text &= String.Format("Result including all elements ({0} elements) & vbCrLf:", _
                  result.Length)
outputBlock.Text &= "   "
For Each s As String In result
   outputBlock.Text &= String.Format("'{0}' ", IIf(String.IsNullOrEmpty(s), "<>", s))
Next
outputBlock.Text &= vbCrLf
outputBlock.Text &= vbCrLf

' Split delimited by another string and return all non-empty elements.
result = source.Split(stringSeparators, _
                      StringSplitOptions.RemoveEmptyEntries)
outputBlock.Text &= String.Format("Result including non-empty elements ({0} elements) & vbCrLf:", _
                  result.Length)
outputBlock.Text &= "   "
For Each s As String In result
   outputBlock.Text &= String.Format("'{0}' ", IIf(String.IsNullOrEmpty(s), "<>", s))
Next
outputBlock.Text &= vbCrLf
' This example displays the following output:
'       Splitting the string:
'          "[stop]ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]".
'       Using the delimiter string:
'          "[stop]"
'             
'       Result using StringSplitOptions.None (all elements):
'          '<>' 'ONE' '<>' 'TWO' '<>' '<>' 'THREE' '<>' '<>'
'            
'       Result using StringSplitOptions.RemoveEmptyEntries:
'          'ONE' 'TWO' 'THREE'

string source = "[stop]ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]";
string[] stringSeparators = new string[] { "[stop]" };
string[] result;

// Display the original string and delimiter string.
outputBlock.Text += String.Format("Splitting the string:\n   \"{0}\".", source) + "\n";
outputBlock.Text += "\n";
outputBlock.Text += String.Format("Using the delimiter string:\n   \"{0}\"",
                  stringSeparators[0]) + "\n";
outputBlock.Text += "\n";

// Split a string delimited by another string and return all elements.
result = source.Split(stringSeparators, StringSplitOptions.None);
outputBlock.Text += String.Format("Result including all elements ({0} elements):",
                  result.Length) + "\n";
outputBlock.Text += "   ";
foreach (string s in result)
{
   outputBlock.Text += String.Format("'{0}' ", String.IsNullOrEmpty(s) ? "<>" : s);
}
outputBlock.Text += "\n";
outputBlock.Text += "\n";

// Split delimited by another string and return all non-empty elements.
result = source.Split(stringSeparators,
                      StringSplitOptions.RemoveEmptyEntries);
outputBlock.Text += String.Format("Result including non-empty elements ({0} elements):",
                  result.Length) + "\n";
outputBlock.Text += "   ";
foreach (string s in result)
{
   outputBlock.Text += String.Format("'{0}' ", String.IsNullOrEmpty(s) ? "<>" : s);
}
outputBlock.Text += "\n";
/*
This example displays the following output:

Splitting the string:
   "[stop]ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]".
Using the delimiter string:
   "[stop]"

Result using StringSplitOptions.None (all elements):
   '<>' 'ONE' '<>' 'TWO' '<>' '<>' 'THREE' '<>' '<>'

Result using StringSplitOptions.RemoveEmptyEntries:
   'ONE' 'TWO' 'THREE'
*/