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 (Int32, Int32)

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

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

public char[] ToCharArray (
	int startIndex,
	int length
)
public char[] ToCharArray (
	int startIndex, 
	int length
)
public function ToCharArray (
	startIndex : int, 
	length : int
) : char[]

Parameters

startIndex

The starting position of a substring in this instance.

length

The length of the substring in this instance.

Return Value

A Unicode character array whose elements are the length number of characters in this instance starting from character position startIndex.

Exception typeCondition

ArgumentOutOfRangeException

startIndex or length is less than zero.

-or-

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

If length is zero, the entire string is copied starting from the beginning of this instance, and ignoring the value of startIndex. If this instance is an empty string (""), the returned array is empty and has a zero length.

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

// Sample for String.ToCharArray(Int32, Int32)
using System;

class Sample {
    public static void Main() {
    string str = "012wxyz789";
    char[] arr;

    arr = str.ToCharArray(3, 4);
    Console.Write("The letters in '{0}' are: '", str);
    Console.Write(arr);
    Console.WriteLine("'");
    Console.WriteLine("Each letter in '{0}' is:", str);
    foreach (char c in arr)
        Console.WriteLine(c);
    }
}
/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/

// Sample for String.ToCharArray(Int32, Int32)
import System.*;

class Sample
{
    public static void main(String[] args)
    {
        String str = "012wxyz789";
        char arr[];

        arr = str.ToCharArray(3, 4);
        Console.Write("The letters in '{0}' are: '", str);
        Console.Write(arr);
        Console.WriteLine("'");
        Console.WriteLine("Each letter in '{0}' is:", str);
        for (int iCtr = 0; iCtr < arr.length; iCtr++) {
            char c = arr[iCtr];
            Console.WriteLine(c);
        }
    } //main
} //Sample
/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0

Community Additions

Show:
© 2014 Microsoft