Метод CopyTo (ADO)

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

Синтаксис

  
Stream.CopyTo DestStream, NumChars  

Параметры

DestStream
Значение переменной объекта, содержащее ссылку на открытый объект Stream . Текущий Поток копируется в целевой Поток,заданный DestStream. Целевой поток уже должен быть открыт. В противном случае возникает ошибка во время выполнения.

Примечание

Параметр DestStream может не быть прокси-сервером объекта Stream, так как для этого требуется доступ к частному интерфейсу объекта Stream , который не может быть удален для клиента.

NumChars
Необязательный элемент. Целочисленное значение, указывающее количество байтов или символов, копируемых из текущей позиции в исходном потоке в целевой поток. Значение по умолчанию — -1, указывающее, что все символы или байты копируются из текущей позиции в EOS.

Комментарии

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

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

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

Применение

Объект Stream (ADO)