CopyTo 메서드(ADO)
Stream에서 지정된 수의 문자 또는 바이트(형식에 따라 다름)를 다른 Stream 개체에 복사합니다.
구문
Stream.CopyTo DestStream, NumChars
매개 변수
DestStream
열린 Stream 개체에 대한 참조를 포함하는 개체 변수 값입니다. 현재 Stream은 DestStream에서 지정한 대상 Stream에 복사됩니다. 대상 Stream이 이미 열려 있어야 합니다. 그렇지 않으면 런타임 오류가 발생합니다.
참고
DestStream 매개 변수는 Stream 개체의 프록시가 아닐 수 있습니다. 이 경우 클라이언트에 원격으로 연결할 수 없는 Stream 개체의 프라이빗 인터페이스에 액세스해야 하기 때문입니다.
NumChars
(선택 사항) 원본 Stream의 현재 위치에서 대상 Stream으로 복사할 바이트 또는 문자 수를 지정하는 Integer 값입니다. 기본값은 -1로, 모든 문자 또는 바이트가 현재 위치에서 EOS로 복사되도록 지정합니다.
설명
이 메서드는 Position 속성에 지정된 현재 위치에서 시작하여 지정된 수의 문자 또는 바이트를 복사합니다. 지정된 숫자가 EOS까지 사용 가능한 바이트 수보다 많은 경우 현재 위치에서 EOS로의 문자 또는 바이트만 복사됩니다. NumChars 값이 -1이거나 생략된 경우 현재 위치에서 시작하는 모든 문자 또는 바이트가 복사됩니다.
대상 스트림에 기존 문자 또는 바이트가 있는 경우 복사가 끝나는 지점을 벗어난 모든 콘텐츠는 그대로 유지되며 잘리지 않습니다. Position은 복사된 마지막 바이트 바로 다음에 바이트가 됩니다. 이러한 바이트를 자르려면 SetEOS를 호출합니다.
CopyTo는 원본 Stream과 동일한 형식의 대상 Stream에 데이터를 복사하는 데 사용해야 합니다(해당 Type 속성 설정은 모두 adTypeText이거나 모두 adTypeBinary임). 텍스트 Stream 개체의 경우 대상 Stream의 Charset 속성 설정을 변경하여 한 문자 집합에서 다른 문자 집합으로 변환할 수 있습니다. 또한 텍스트 Stream 개체를 이진 Stream 개체로 성공적으로 복사할 수 있지만 이진 Stream 개체는 텍스트 Stream 개체로 복사할 수 없습니다.