SALES: 1-800-867-1380
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

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
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft