ADO: ActiveX Data Objects

Name

Stream.SaveToFile Method — (Versions 2.5, 2.6)

Synopsis

stream.SaveToFile (FileName, SaveOptions)

The SaveToFile method persists the data of a binary stream to a local file.

Arguments

FileName (String)

Indicates where the contents of the current Stream object are to be persisted.

SaveOptions (SaveOptionsEnum)

Specifies whether a file is to be created if one doesn’t exist, if an existing file should be overwritten, or, if a file already exists, whether an error should occur.

Description

The SaveToFile method completely overwrites an existing file if the adSaveCreateOverwrite enumeration value is used in the SaveOptions argument.

Using this method does not change the contents of the Stream object nor its association to the original resource with which the Stream object was opened. The only difference from the Stream object is that the Position property is set to the beginning of the stream (0).

See Also

SaveOptionsEnum Enumeration, Stream.Position Property