Método CopyTo (ADO)
Copia el número especificado de caracteres o bytes (dependiendo de Type) en el stream de en otro objeto stream de.
Sintaxis
Stream.CopyTo DestStream, NumChars
Parámetros
DestStream
Valor de variable de objeto que contiene una referencia a un objeto Stream abierto. El stream de actual se copia en el stream de destino especificado por DestStream. El destino stream debe estar abierto. Si no es así, se produce un error en tiempo de ejecución.
Nota
Es posible que el parámetro de DestStream no sea un proxy de objeto Stream porque esto requiere acceso a una interfaz privada en el objeto Stream que no se puede remoto al cliente.
NumChars
Opcional. Valor de entero que especifica el número de bytes o caracteres que se van a copiar de la posición actual en el stream de origen al destino Stream. El valor predeterminado es -1, que especifica que todos los caracteres o bytes se copian de la posición actual a EOS.
Observaciones
Este método copia el número especificado de caracteres o bytes, empezando por la posición actual especificada por la propiedad position Position. Si el número especificado es mayor que el número disponible de bytes hasta que EOS, solo se copian los caracteres o bytes de la posición actual a EOS. Si el valor de NumChars es -1 o se omite, se copian todos los caracteres o bytes a partir de la posición actual.
Si hay caracteres o bytes existentes en la secuencia de destino, todo el contenido más allá del punto donde finaliza la copia permanece y no se trunca. Position se convierte en el byte inmediatamente después del último byte copiado. Si desea truncar estos bytes, llame a SetEOS.
copyTo debe usarse para copiar datos en un stream de destino del mismo tipo que el stream de origen (la configuración de la propiedad Type son adTypeText o ambas adTypeBinary). En el caso de los objetos de stream de texto, puede cambiar el valor de la propiedad charset del destino Stream para traducir de un juego de caracteres a otro. Además, los objetos de Stream de stream se pueden copiar correctamente en objetos de stream binarios, pero los objetos de stream binarios stream no se pueden copiar en objetos de Stream de texto.