String.CopyTo Method (Int32, Char[], Int32, Int32)
Copies a specified number of characters from a specified position in this instance to a specified position in an array of Unicode characters.
Assembly: mscorlib (in mscorlib.dll)
member CopyTo : sourceIndex:int * destination:char[] * destinationIndex:int * count:int -> unit
Parameters
- sourceIndex
-
Type:
System.Int32
The index of the first character in this instance to copy.
- destination
-
Type:
System.Char[]
An array of Unicode characters to which characters in this instance are copied.
- destinationIndex
-
Type:
System.Int32
The index in destination at which the copy operation begins.
- count
-
Type:
System.Int32
The number of characters in this instance to copy to destination.
| Exception | Condition |
|---|---|
| ArgumentNullException | destination is null. |
| ArgumentOutOfRangeException | sourceIndex, destinationIndex, or count is negative -or- sourceIndex does not identify a position in the current instance. -or- destinationIndex does not identify a valid index in the destination array. -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 the destination array. |
This method copies count characters from the sourceIndex position of this instance to the destinationIndex position of destination character array. This method does not resize the destination character array; it must have a sufficient number of elements to accommodate the copied characters or the method throws an ArgumentOutOfRangeException.
sourceIndex and destinationIndex are zero-based.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1