Método CopyTo (ADO)
Copia o número especificado de caracteres ou bytes (dependendo de Type) no do 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 do é copiado para o de fluxo de de destino especificado pelo DestStream. O destino Stream já deve estar aberto. Caso contrário, ocorrerá um erro em tempo de execução.
Nota
O parâmetro DestStream pode não ser um proxy do objeto Stream porque isso requer acesso a uma interface privada no objeto Stream que não pode ser remoto para o cliente.
numchars
Opcional. Um valor Inteiro que especifica o número de bytes ou caracteres a serem copiados da posição atual no stream de de origem para o destino Stream. O valor padrão é -1, que especifica que todos os caracteres ou bytes são copiados da posição atual para do EOS.
Observações
Esse método copia o número especificado de caracteres ou bytes, começando da posição atual especificada pela propriedade Position. Se o número especificado for maior do que o número disponível de bytes até EOS, somente caracteres ou bytes da posição atual para do EOS serão copiados. Se o valor de NumChars for -1 ou omitido, todos os caracteres ou bytes a partir da 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 permanece e não são truncados. Position torna-se o byte imediatamente após o último byte copiado. Se você quiser truncar esses bytes, chame SetEOS.
CopyTo deve ser usado para copiar dados para um stream de destino do mesmo tipo que o stream de origem (suas configurações de propriedade tipo são adTypeText ou ambos adTypeBinary). Para texto stream objetos, você pode alterar a configuração da propriedade charset do destino Stream para traduzir de um conjunto de caracteres para outro. Além disso, os objetos stream de de texto podem ser copiados com êxito em objetos de stream de binários, mas os objetos do Stream de binários não podem ser copiados em objetos stream de texto.