String.CopyTo(Int32, Char[], Int32, Int32) String.CopyTo(Int32, Char[], Int32, Int32) String.CopyTo(Int32, Char[], Int32, Int32) String.CopyTo(Int32, Char[], Int32, Int32) Method

정의

이 인스턴스의 지정한 위치에 있는 지정한 수의 문자를 유니코드 문자 배열의 특정 위치에 복사합니다.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 Int32 Int32 Int32

이 인스턴스에서 복사할 첫 번째 문자의 인덱스입니다.The index of the first character in this instance to copy.

destination
Char[]

이 인스턴스의 문자가 복사되는 유니코드 문자의 배열입니다.An array of Unicode characters to which characters in this instance are copied.

destinationIndex
Int32 Int32 Int32 Int32

destination에서 복사 작업이 시작되는 인덱스입니다.The index in destination at which the copy operation begins.

count
Int32 Int32 Int32 Int32

이 인스턴스에서 destination에 복사할 문자의 수입니다.The number of characters in this instance to copy to destination.

예외

sourceIndex, destinationIndex또는 count이(가) 음수입니다.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 이(가) destinationIndex 부터 destination 배열 끝까지의 하위 문자열 길이보다 큽니다.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 이 인스턴스의 위치를 destinationIndex 의 위치가 destination 문자 배열입니다.This method copies count characters from the sourceIndex position of this instance to the destinationIndex position of destination character array. 이 메서드는 크기를 조정 하지 합니다 destination 문자 배열; 요소는 복사한 문자에 맞게 충분 한 수 있어야 또는 메서드에서 throw는 ArgumentOutOfRangeException합니다.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.

sourceIndexdestinationIndex 0부터 시작 됩니다.sourceIndex and destinationIndex are zero-based.

적용 대상

추가 정보