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.

The following code example demonstrates how to easily create a Unicode character array from a String. The array is then used with the Split method.

using System;

public class Example
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
      string delimStr = " ,.:";
      char[] delimiter = delimStr.ToCharArray();
      string words = "one two,three:four.";
      string[] split = null;

      outputBlock.Text += "The delimiters are:" + "\n";
      foreach (char ch in delimStr)
         outputBlock.Text += String.Format("   '{0}'", ch) + "\n";

      outputBlock.Text += "\n";

      split = words.Split(delimiter);
      foreach (string s in split)
         outputBlock.Text += String.Format("'{0}'", s) + "\n";
// The example displays the following output:
//       The delimiters are:
//          ''
//          ','
//          '.'
//          ':'
//       'one'
//       'two'
//       'three'
//       'four'
//       ''    


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions