Compartir a través de

CopyTo (método) (ADO)

  • Artículo

Copia el número especificado de caracteres o bytes (en función de Type) del objeto Stream en otro objeto Stream.

Sintaxis

  
Stream.CopyTo DestStream, NumChars

Parámetros

DestStream
Valor de variable de objeto que contiene una referencia a un objeto Stream abierto. El Stream actual se copia en el objeto Stream de destino especificado por DestStream. El objeto Stream de destino ya debe estar abierto. Si no es así, se produce un error de ejecución.

Nota

Es posible que el parámetro DestStream no sea un proxy del objeto Stream porque esto requiere acceso a una interfaz privada en el objeto Stream que no se puede remoto al cliente.

NumChars
Opcional. Un valor Entero que especifica el número de bytes o caracteres que se van a copiar de la posición actual en el objeto Stream de origen al objeto Stream de destino. El valor predeterminado es -1, que especifica que todos los caracteres o bytes se copian de la posición actual a EOS.

Comentarios

Este método copia el número especificado de caracteres o bytes, empezando por la posición actual especificada por la propiedad Position. Si el número especificado es mayor que el número disponible de bytes hasta 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 en el que permanece la copia y no se trunca. Position se convierte en el byte inmediatamente después del último byte copiado. Si desea truncar estos bytes, llame al método SetEOS.

CopyTo debe usarse para copiar datos en un objeto Stream de destino del mismo tipo que el Stream de origen (su configuración de la propiedad Type es adTypeText o adTypeBinary). En el caso de los objetos Stream de texto, puede cambiar el valor de la propiedad Charset del objeto Stream de destino para traducir de un juego de caracteres a otro. Además, los objetos Stream de texto se pueden copiar correctamente en objetos Stream binarios, pero los objetos Stream binarios no se pueden copiar en objetos Stream de texto.

Se aplica a

Objeto de secuencia (ADO)