SaveToFile 方法 (ADO)

适用于:Access 2013、Office 2013

可将 Stream 的二进制内容保存到文件。

语法

Stream。SaveToFileFileNameSaveOptions

参数

参数 说明
FileName 字符串型 值,包含要保存 Stream 内容的文件的完全限定名称。 可以保存到任意一个有效的本地位置或可通过 UNC 值访问的任意位置。
SaveOptions SaveOptionsEnum 值,指定 SaveToFile 是否应在文件不存在时创建新文件。 默认值为 adSaveCreateNotExists。 通过这些选项,可以指定当指定文件不存在时引发错误。 还可以指定 SaveToFile 覆盖现有文件的当前内容。

注意

如果覆盖现有文件(在设置 adSaveCreateOverwrite 时),则 SaveToFile 会从覆盖之前的原文件中截去新的 EOS 之后的所有字节。

备注

SaveToFile 可以用于将 Stream 对象的内容复制到本地文件。 Stream 对象的内容或属性都不会发生变化。 在调用 SaveToFile 之前,必须打开 Stream 对象。

此方法不会更改 Stream 对象与其基础源之间的关联性。 Stream 对象将仍与打开时作为其来源的原始 URL 或 Record 相关联。

SaveToFile 操作之后,流中的当前位置(Position 属性 (ADO))设置为流的开头 (0)。