Método CopyTo (ADO)
Se aplica a: Access 2013, Office 2013
Copia el número especificado de caracteres o bytes (según Type) de un objeto Stream a otro objeto Stream.
Stream. CopyTo DestStream, NumChars
Parámetro | Descripción |
---|---|
DestStream | Valor de variable de objeto que contiene una referencia a un objeto Stream abierto. El actual objeto Stream se copia en el objeto Stream de destino especificado por DestStream. El objeto Stream de destino ya debe estar abierto. De lo contrario, se produce un error en tiempo de ejecución. NOTA: Es posible que el parámetro DestStream no sea un proxy del objeto Stream porque requiere acceso a una interfaz privada en el objeto Stream que no se puede remotar al cliente. |
NumChars | Es opcional. Valor de tipo Integer que especifica el número de bytes o caracteres que se van a copiar a partir de la actual posición en el objeto Stream de origen al objeto Stream de destino. El valor predeterminado es –1, que especifica que se van a copiar todos los caracteres o bytes desde la posición actual hasta EOS. |
Este método copia el número especificado de caracteres o bytes, a partir de la actual posición especificada por la propiedad Position. Si el número especificado es mayor que el número de bytes disponibles hasta EOS, sólo se copiarán los caracteres o bytes desde la posición actual hasta EOS. Si el valor de NumChars es –1 o se omite, se copiarán todos los caracteres o bytes a partir de la posición actual.
Si hay caracteres o bytes en la secuencia de destino, se mantiene todo el contenido situado más allá del punto donde finaliza la copia y no se ve truncado. El valor de Position será el byte inmediatamente después del último byte copiado. Si desea truncar estos bytes, llame a SetEOS.
CopyTo debe utilizarse para copiar datos a un objeto Stream de destino del mismo tipo que el objeto Stream de origen (el valor de la propiedad Type de ambos objetos debe ser adTypeText o adTypeBinary). Para los objetos Stream de texto, puede cambiar la configuración de la propiedad Charset del objeto Stream de destino para permitir la conversión de un juego de caracteres a otro. Also, text Stream objects can be successfully copied into binary Stream objects, but binary Stream objects cannot be copied into text Stream objects.