내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StringBuilder.CopyTo 메서드

2013-12-13

이 인스턴스에서 지정한 세그먼트의 문자를 대상 Char 배열에서 지정한 세그먼트에 복사합니다.

Namespace:  System.Text
어셈블리:  mscorlib(mscorlib.dll)

public void CopyTo(
	int sourceIndex,
	char[] destination,
	int destinationIndex,
	int count
)

매개 변수

sourceIndex
형식: System.Int32
이 인스턴스에서 문자가 복사되기 시작하는 위치입니다. 인덱스는 0부터 시작합니다.
destination
형식: System.Char []
문자가 복사될 배열입니다.
destinationIndex
형식: System.Int32
destination에서 문자 복사가 시작될 위치입니다. 인덱스는 0부터 시작합니다.
count
형식: System.Int32
복사될 문자 수입니다.

예외조건
ArgumentNullException

destinationnull인 경우

ArgumentOutOfRangeException

sourceIndex, destinationIndex 또는 count가 0보다 작은 경우

-또는-

sourceIndex가 이 인스턴스의 길이보다 큰 경우

ArgumentException

sourceIndexcount의 합이 이 인스턴스의 길이보다 큰 경우

-또는-

destinationIndexcount의 합이 destination의 길이보다 큰 경우

CopyTo 메서드는 StringBuilder 개체의 연속 섹션을 배열에 효과적으로 복사해야 하는 아주 드문 경우에 사용할 수 있습니다. 배열은 고정된 크기여야 하고, 미리 할당되어야 하고, 다시 사용할 수 있어야 하며, 전역 액세스가 가능해야 합니다.

예를 들어, 응용프로그램에서 StringBuilder 개체를 많은 수의 문자로 채운 다음, CopyTo 메서드를 사용하여 StringBuilder 개체의 연속된 작은 조각을 처리할 배열에 복사할 수 있습니다. StringBuilder 개체의 모든 데이터가 처리되면 StringBuilder 개체의 크기가 0으로 설정되고 주기가 반복됩니다.

다음 예제에서는 CopyTo 메서드를 보여 줍니다.

Windows Phone OS

지원되는 버전: 8.0

표시:
© 2014 Microsoft