String.CopyTo(Int32, Char[], Int32, Int32) 方法

定義

將字元的指定數目從這個執行個體的指定位置,複製到 Unicode 字元陣列的指定位置。Copies a specified number of characters from a specified position in this instance to a specified position in an array of Unicode characters.

public:
 void CopyTo(int sourceIndex, cli::array <char> ^ destination, int destinationIndex, int count);
public void CopyTo (int sourceIndex, char[] destination, int destinationIndex, int count);
member this.CopyTo : int * char[] * int * int -> unit
Public Sub CopyTo (sourceIndex As Integer, destination As Char(), destinationIndex As Integer, count As Integer)

參數

sourceIndex
Int32

這個要複製的執行個體中第一個字元的索引。The index of the first character in this instance to copy.

destination
Char[]

複製這個執行個體之字元的目標 Unicode 字元陣列。An array of Unicode characters to which characters in this instance are copied.

destinationIndex
Int32

destination 中開始複製作業的索引。The index in destination at which the copy operation begins.

count
Int32

這個執行個體中要複製到 destination 的字元數。The number of characters in this instance to copy to destination.

例外狀況

destinationnulldestination is null.

sourceIndexdestinationIndexcount 為負。sourceIndex, destinationIndex, or count is negative -或--or- sourceIndex 未識別目前執行個體中的位置。sourceIndex does not identify a position in the current instance.

-或--or- destinationIndex 未識別 destination 陣列中的有效索引。destinationIndex does not identify a valid index in the destination array.

-或--or- count 大於從 sourceIndex 到這個執行個體結尾的子字串長度。count is greater than the length of the substring from sourceIndex to the end of this instance -或--or- count 大於從 destinationIndexdestination 陣列結尾的子陣列長度。count is greater than the length of the subarray from destinationIndex to the end of the destination array.

範例

下列範例示範 CopyTo 方法。The following example demonstrates the CopyTo method.

using namespace System;
int main()
{
   
   // Embed an array of characters in a string
   String^ strSource = "changed";
   array<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 );
}
// The example displays the following output:
//       The initial array
//       The changed array
//       Thedifferentarray
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 );
    }
}
// The example displays the following output:
//       The initial array
//       The changed array
//       Thedifferentarray
Public Class CopyToTest
    Public Shared Sub Main()
        ' Embed an array of characters in a string
        Dim strSource As String = "changed"
        Dim destination As Char() = {"T"c, "h"c, "e"c, " "c, "i"c, "n"c, "i"c, _
                    "t"c, "i"c, "a"c, "l"c, " "c, "a"c, "r"c, "r"c, "a"c, "y"c}

        ' 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)
    End Sub 
End Class 
' The example displays the following output:
'       The initial array
'       The changed array
'       Thedifferentarray

備註

這個方法會將 count 個字元從這個實例的 sourceIndex 位置複製到 destination 字元陣列的 destinationIndex 位置。This method copies count characters from the sourceIndex position of this instance to the destinationIndex position of destination character array. 這個方法不會調整 destination 字元陣列的大小;它必須有足夠數目的元素來容納複製的字元,否則方法會擲回 ArgumentOutOfRangeExceptionThis 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.

sourceIndexdestinationIndex 是以零為基底。sourceIndex and destinationIndex are zero-based.

適用於

另請參閱