Método SaveToFile

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

Sintaxis

  
Stream.SaveToFile FileName, SaveOptions  

Parámetros

FileName
Valor de tipo String que contiene el nombre completo del archivo en el que se guardará el contenido del objeto Stream. Se puede guardar en cualquier ubicación local válida o cualquier ubicación a la que tenga acceso a través de un valor UNC.

SaveOptions
Valor de tipo SaveOptionsEnum que especifica si SaveToFile debe crear un nuevo archivo, si aún no existe. El valor predeterminado es adSaveCreateNotExists. Con estas opciones se puede indicar que se ha producido un error si el archivo especificado no existe. También se puede indicar que SaveToFile sobrescribe el contenido actual de un archivo existente.

Nota

Si se sobrescribe un archivo existente (cuando se establece adSaveCreateOverwrite), SaveToFile trunca los bytes del archivo original existente que siguen al nuevo EOS.

Comentarios

Se puede usar SaveToFile para copiar el contenido de un objeto Stream en un archivo local. No hay ningún cambio en el contenido ni en las propiedades del objeto Stream. El objeto Stream debe estar abierto antes de llamar a SaveToFile.

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

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

Se aplica a

Objeto de secuencia (ADO)

Consulte también

Open (método) (Stream de ADO)
Save (método)