Метод CopyTo (ADO)
Копирует указанное число символов или байтов (в зависимости от типа) в Stream в другой объект Stream Stream.
Синтаксис
Stream.CopyTo DestStream, NumChars
Параметры
DestStream
Значение переменной объекта, содержащее ссылку на открытый объект Stream. Текущий Stream копируется в целевой Stream, указанный DestStream. Целевой Stream должен быть открыт. В противном случае возникает ошибка во время выполнения.
Заметка
Параметр DestStream не может быть прокси-сервером объекта stream Stream, так как для этого требуется доступ к частному интерфейсу в объекте Stream, который не может быть удален клиенту.
NumChars
Необязательный. Значение целочисленного, указывающее количество байтов или символов, скопированных из текущей позиции в исходном Stream в целевой Stream. Значение по умолчанию — -1, указывающее, что все символы или байты копируются из текущей позиции в EOS.
Замечания
Этот метод копирует указанное количество символов или байтов, начиная с текущей позиции, указанной свойством Position. Если указанное число превышает доступное число байтов, пока EOS, копируются только символы или байты из текущей позиции в EOS. Если значение NumChars равно -1 или опущено, все символы или байты, начиная с текущей позиции, копируются.
Если в целевом потоке имеются символы или байты, все содержимое за пределами точки, в которой заканчивается копирование, и не усечено. положение становится байтом сразу после последнего скопированного байта. Если вы хотите усечь эти байты, вызовите SetEOS.
CopyTo следует использовать для копирования данных в целевой Stream того же типа, что и исходный Stream (параметры свойств типа adTypeText или как adTypeBinary). Для текстовых объектов Stream можно изменить параметр свойства Charset целевого Stream для перевода из одного набора символов в другой. Кроме того, объекты Stream stream можно успешно скопировать в двоичные объекты Stream Stream, но двоичные объекты Stream невозможно скопировать в текстовые объекты stream Stream.