Método SaveToFile (ADO)

Se aplica a: Access 2013, Office 2013

Guarda el contenido binario de un objeto Stream en un archivo.

Sintaxis

Stream. SaveToFileFileName, SaveOptions

Parámetros

Parámetro	Descripción
FileName	Valor de tipo String que contiene el nombre completo del archivo en el que se va a guardar el contenido del objeto Stream. Se puede guardar en cualquier ubicación local válida o cualquier ubicación a la que se tenga acceso mediante un valor UNC.
SaveOptions	Valor de SaveOptionsEnum que especifica si SaveToFile debe crear un archivo nuevo si aún no existe. El valor predeterminado es adSaveCreateNotExists. Con estas opciones, se puede especificar que se genere un error si no existe el archivo indicado. Asimismo, se puede especificar que SaveToFile sobrescriba el contenido de un archivo existente.

Nota:

Si se sobrescribe un archivo existente (cuando se ha establecido el valor adSaveCreateOverwrite), SaveToFile truncará los bytes del archivo existente original que aparezcan después del nuevo EOS.

Comentarios

SaveToFile puede utilizarse para copiar el contenido de un objeto Stream en un archivo local. No se produce ningún cambio en el contenido ni en las propiedades del objeto Stream. El objeto Stream debe estar abierto antes de que se llame a SaveToFile.

Este método no cambia la asociación del objeto Stream a su origen subyacente. El objeto Stream permanecerá asociado a la dirección URL original o al objeto Record que era su origen al abrirse.

Después de una operación de SaveToFile, la posición actual (Position) en la secuencia se establece en el principio de la secuencia (0).