Метод CopyTo (ADO)

Область применения: Access 2013, Office 2013

Копирует указанное количество символов или байтов (в зависимости от типа) в Stream в другой объект Stream.

Синтаксис

Stream. CopyTo DestStream, NumChars

Параметры

Параметр	Описание
DestStream	Значение переменной объекта, содержащее ссылку на открытый объект Stream. Текущий Stream копируется в целевой Stream, указанныйDestStream. Конечный Stream уже должен быть открыт. В противном случае возникает ошибка во время выполнения. ПРИМЕЧАНИЕ. Параметр DestStream не может быть прокси-сервером объекта Stream, так как для этого требуется доступ к частному интерфейсу объекта Stream, который не может быть удален для клиента.
NumChars	Необязательный параметр. Целочисленное значение, указывающее количество байтов или символов, копируемых из текущей позиции в исходном Stream в целевой Stream. Значение по умолчанию — –1, указывающее, что все символы или байты копируются из текущей позиции в EOS.

Замечания

Этот метод копирует указанное количество символов или байтов, начиная с текущей позиции, указанной свойством Position . Если указанное число больше, чем доступное число байтов до EOS, копируются только символы или байты из текущей позиции в EOS . Если значение NumChars равно –1 или опущено, копируются все символы или байты, начиная с текущей позиции.

Если в целевом потоке есть символы или байты, все содержимое за пределами точки окончания копирования остается и не усекается. Позиция становится байтом сразу после последнего скопированного байта. Если вы хотите усечь эти байты, вызовите SetEOS.

CopyTo следует использовать для копирования данных в целевой Stream того же типа, что и исходный Stream (параметры свойств Type — adTypeText или adTypeBinary). Для текстовых Stream объектов можно изменить параметр свойства Charset целевого Stream для перевода из одного набора символов в другой. Кроме того, текстовые объекты Stream можно успешно скопировать в двоичные объекты Stream, но двоичные объекты Stream нельзя скопировать в текстовые объекты Stream.