String.CopyTo Method
Assembly: mscorlib (in mscorlib.dll)
public void CopyTo ( int sourceIndex, char[] destination, int destinationIndex, int count )
public function CopyTo ( sourceIndex : int, destination : char[], destinationIndex : int, count : int )
Parameters
- sourceIndex
A character position in this instance.
- destination
An array of Unicode characters.
- destinationIndex
An array element in destination.
- count
The number of characters in this instance to copy to destination.
| Exception type | Condition |
|---|---|
| destination is a null reference (Nothing in Visual Basic). | |
| sourceIndex, destinationIndex, or count is negative -or- count is greater than the length of the substring from startIndex to the end of this instance -or- count is greater than the length of the subarray from destinationIndex to the end of destination |
The following code example demonstrates the CopyTo method.
using System; public class CopyToTest { public static void Main() { // Embed an array of characters in a string string strSource = "changed"; char [] destination = { 'T', 'h', 'e', ' ', 'i', 'n', 'i', 't', 'i', 'a', 'l', ' ', 'a', 'r', 'r', 'a', 'y' }; // Print the char array Console.WriteLine( destination ); // Embed the source string in the destination string strSource.CopyTo ( 0, destination, 4, strSource.Length ); // Print the resulting array Console.WriteLine( destination ); strSource = "A different string"; // Embed only a section of the source string in the destination strSource.CopyTo ( 2, destination, 3, 9 ); // Print the resulting array Console.WriteLine( destination ); } }
import System.*;
public class CopyToTest
{
public static void main(String[] args)
{
// Embed an array of characters in a string
String strSource = "changed";
char destination[] = { 'T', 'h', 'e', ' ', 'i', 'n', 'i', 't', 'i',
'a', 'l', ' ', 'a', 'r', 'r', 'a', 'y' };
// Print the char array
Console.WriteLine(destination);
// Embed the source string in the destination string
strSource.CopyTo(0, destination, 4, strSource.get_Length());
// Print the resulting array
Console.WriteLine(destination);
strSource = "A different string";
// Embed only a section of the source string in the destination
strSource.CopyTo(2, destination, 3, 9);
// Print the resulting array
Console.WriteLine(destination);
} //main
} //CopyToTest
import System; public class CopyToTest { public static function Main() : void { // Embed an array of characters in a string var strSource : String = "changed"; var destination : char[] = "The initial array".ToCharArray(); // Print the char array Console.WriteLine( destination ); // Embed the source string in the destination string strSource.CopyTo ( 0, destination, 4, strSource.Length ); // Print the resulting array Console.WriteLine( destination ); strSource = "A different string"; // Embed only a section of the source string in the destination strSource.CopyTo ( 2, destination, 3, 9 ); // Print the resulting array Console.WriteLine( destination ); } } CopyToTest.Main();
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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.
