Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

String.ToCharArray Method

Copies the characters in this instance to a Unicode character array.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
Public Function ToCharArray As Char()

Return Value

Type: System.Char()
A Unicode character array whose elements are the individual characters of this instance. If this instance is an empty string, the returned array is empty and has a zero length.

This method copies each character (that is, each Char object) in a string to a character array. The first character copied is at index zero of the returned character array; the last character copied is at index Array.Length – 1.

To create a string from the characters in a character array, call the String(Char()) constructor.

The following example demonstrates how to easily create a Unicode character array from a String. The array is then supplied as the separator argument to the Split method.

Public Class StringSplit2
   Public Shared Sub Main()

      Dim delimStr As String = " ,.:" 
      Dim delimiter As Char() = delimStr.ToCharArray()
      Dim words As String = "one two,three:four." 
      Dim split As String() = Nothing

      Console.WriteLine("The delimiters are -{0}-", delimStr)
      Dim x As Integer 
      For x = 1 To 5
         split = words.Split(delimiter, x)
         Console.WriteLine(ControlChars.Cr + "count = {0,2} ..............", x)
         Dim s As String 
         For Each s In  split
            Console.WriteLine("-{0}-", s)
         Next s
      Next x
   End Sub  
End Class  
' The example displays the following output: 
'       The delimiters are - ,.:- 
'       count =  1 .............. 
'       -one two,three:four.- 
'       count =  2 .............. 
'       -one- 
'       -two,three:four.- 
'       count =  3 .............. 
'       -one- 
'       -two- 
'       -three:four.- 
'       count =  4 .............. 
'       -one- 
'       -two- 
'       -three- 
'       -four.- 
'       count =  5 .............. 
'       -one- 
'       -two- 
'       -three- 
'       -four- 
'       --

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft