String.ToCharArray Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Copies the characters in this instance to a Unicode character array.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<SecuritySafeCriticalAttribute> _
Public Function ToCharArray As Char()
[SecuritySafeCriticalAttribute]
public char[] ToCharArray()
Return Value
Type: array<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.
Examples
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.
Public Class Example
Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
Dim delimStr As String = " ,.:"
Dim delimiter() As Char = delimStr.ToCharArray()
Dim words As String = "one two,three:four."
Dim split() As String = Nothing
outputBlock.Text &= "The delimiters are:" & vbCrLf
For Each ch As Char In delimStr
outputBlock.Text &= String.Format(" '{0}'", ch) + vbCrLf
Next
outputBlock.Text &= vbCrLf
split = words.Split(delimiter)
For Each s As String In split
outputBlock.Text += String.Format("'{0}'", s) & vbCrLf
Next
End Sub
End Class
' The example displays the following output:
'
' The delimiters are:
' ''
' ','
' '.'
' ':'
'
' 'one'
' 'two'
' 'three'
' 'four'
' ''
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'
// ''
Version Information
Silverlight
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
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.