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.

The following example demonstrates how to easily create a Unicode character array from a String. The array is then used with 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.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft