Compartilhar via

Método CopyTo (ADO)

  • Artigo

Copia o número especificado de caracteres ou bytes (dependendo do Type) no Stream para outro objeto Stream.

Sintaxe

  
Stream.CopyTo DestStream, NumChars

Parâmetros

DestStream
Um valor de variável de objeto que contém uma referência a um objeto Stream aberto. O Stream atual é copiado para o Stream de destino especificado pelo DestStream. O Stream de destino já precisa estar aberto. Caos contrário, ocorrerá um erro em tempo de execução.

Observação

O parâmetro DestStream pode não ser um proxy do objeto Stream porque isso exige acesso a uma interface privada no objeto Stream que não pode ser remoto para o cliente.

NumChars
Opcional. Um valor Integer que especifica o número de bytes ou de caracteres a serem copiados da posição atual no Stream de origem para o Stream de destino. O valor padrão é -1, que especifica que todos os caracteres ou bytes são copiados da posição atual para o EOS.

Comentários

Esse método copia o número especificado de caracteres ou de bytes, começando pela posição atual especificada pela propriedade Position. Se o número especificado for maior que o número disponível de bytes até o EOS, somente os caracteres ou os bytes da posição atual para o EOS serão copiados. Se o valor de NumChars for -1 ou omitido, todos os caracteres ou bytes que começam na posição atual serão copiados.

Se houver caracteres ou bytes existentes no fluxo de destino, todo o conteúdo além do ponto em que a cópia termina permanecerão e não serão truncados. Position torna-se o byte imediatamente após o último byte copiado. Caso deseje truncar esses bytes, chame SetEOS.

CopyTo deve ser usado para copiar dados para um Stream de destino do mesmo tipo do Stream de origem (as configurações da propriedade Type são adTypeText ou adTypeBinary). Para objetos Stream de texto, você pode alterar a configuração da propriedade Charset do Stream de destino a fim de converter de um conjunto de caracteres em outro. Além disso, os objetos Stream de texto podem ser copiados com sucesso em objetos Stream binários, mas os objetos Stream binários não podem ser copiados para objetos Stream de texto.

Aplica-se A

Objeto Stream (ADO)