Parameters

sourceIndex

A int containing the index of the current instance from which to copy.

destination

An array of Unicode characters.

destinationIndex

A int containing the index of an array element in destination to copy.

count

A int containing the number of characters in the current instance to copy to destination.

Exceptions

Type	Reason
ArgumentNullException	destination is a null reference.
ArgumentOutOfRangeException	sourceIndex, destinationIndex, or count is negative -or- count is greater than the length of the substring from startIndex to the end of the current instance -or- count is greater than the length of the subarray from destinationIndex to the end of destination

Remarks

Documentation for this section has not yet been entered.

Example

The following example demonstrates copying characters from a string to a Unicode character array.

C# Example

using System;
public class StringCopyToExample {
 public static void Main() {
 string str = "this is the new string";
 Char[] cAry = {'t','h','e',' ','o','l','d'};
 Console.WriteLine( "The initial string is '{0}'", str );
 Console.Write( "The initial character array is: '" );
 foreach( Char c in cAry)
 Console.Write( c );
 Console.WriteLine( "'" );
 str.CopyTo( 12, cAry, 4, 3 );
 Console.Write( "The character array after CopyTo is: '" );
 foreach( Char c in cAry)
 Console.Write( c );
 Console.WriteLine("'");
 }
}
   

The output is

The initial string is 'this is the new string'
The initial character array is: 'the old'
The character array after CopyTo is: 'the new'

Requirements

Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0