String.ToCharArray Method (Int32, Int32)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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

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


Public Function ToCharArray ( _
    startIndex As Integer, _
    length As Integer _
) As Char()
public char[] ToCharArray(
    int startIndex,
    int length


  • startIndex
    Type: System..::.Int32
    The starting position of a substring in this instance.

Return Value

Type: array<System..::.Char>[]()[]
A Unicode character array whose elements are the length number of characters in this instance starting from character position startIndex.


Exception Condition

startIndex or length is less than zero.


startIndex plus length is greater than the length of this instance.


The startIndex parameter is zero-based. That is, the index of the first character in the string instance is zero.

If length is zero, the returned array is empty and has a zero length. If this instance is nullNothingnullptra null reference (Nothing in Visual Basic) or an empty string (""), the returned array is empty and has a zero length.


The following example converts a substring within a string to an array of characters, and then enumerates and displays the elements of the array.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0

See Also


String Class

ToCharArray Overload

System Namespace