Поделиться через


Метод SaveToFile (ADO)

Область применения: Access 2013, Office 2013

Сохраняет двоичное содержимое Stream в файл.

Синтаксис

Stream. SaveToFileFileName, SaveOptions

Параметры

Параметр Описание
FileName Строковое значение, содержащее полное имя файла, в котором будет сохранено содержимое Stream. Вы можете сохранить данные в любом допустимом локальном расположении или в любом расположении, к которое у вас есть доступ, с помощью значения UNC.
SaveOptions Значение SaveOptionsEnum , указывающее, следует ли создать новый файл с помощью SaveToFile, если он еще не существует. Значение по умолчанию — adSaveCreateNotExists. С помощью этих параметров можно указать, что если указанный файл не существует, возникает ошибка. Можно также указать, что SaveToFile перезаписывает текущее содержимое существующего файла.

Примечание.

При перезаписи существующего файла (если задан параметр adSaveCreateOverwrite ), SaveToFile усекает все байты из исходного существующего файла, следующего за новой EOS.

Замечания

SaveToFile можно использовать для копирования содержимого объекта Stream в локальный файл. Содержимое или свойства объекта Stream не изменяются. Объект Stream должен быть открыт перед вызовом SaveToFile.

Этот метод не изменяет связь объекта Stream с его базовым источником. Объект Stream по-прежнему будет связан с исходным URL-адресом или записью, который был его источником при открытии.

После операции SaveToFile текущей позиции (Position) в потоке устанавливается начало потока (0).