Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ToCharArray Method
Collapse the table of content
Expand the table of content

String.ToCharArray Method

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

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

public char[] ToCharArray()

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.

using System;

public class StringSplit2 
{
   public static void Main() 
   {
      string delimStr = " ,.:";
	   char [] delimiter = delimStr.ToCharArray();
      string words = "one two,three:four.";
      string [] split = null;

	   Console.WriteLine("The delimiters are -{0}-", delimStr);
	   for (int x = 1; x <= 5; x++) 
      {
	      split = words.Split(delimiter, x);
         Console.WriteLine("\ncount = {0,2} ..............", x);
	       foreach (string s in split) 
          {
             Console.WriteLine("-{0}-", s);
  	       }
	   }
   }
}
// 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

.NET for Windows Phone apps

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

Portable Class Library

Supported in: Portable Class Library
Show:
© 2015 Microsoft