SaveToFile 方法
將 Stream 的二進位內容儲存至檔案。
語法
Stream.SaveToFile FileName, SaveOptions
參數
FileName
String 值,其中包含將儲存 Stream 內容之檔案的完整名稱。 您可以儲存至任何有效的本機位置,或您可以透過 UNC 值存取的任何位置。
SaveOptions
SaveOptionsEnum 值,指定如果它不存在,SaveToFile是否應該建立新的檔案。 預設值為 adSaveCreateNotExists。 使用這些選項,您可以指定如果指定的檔案不存在,就會發生錯誤。 您也可以指定 saveToFile 覆寫現有檔案的目前內容。
注意
如果您覆寫現有的檔案(設定 adSaveCreateCreateOverwrite 時),SaveToFile 會截斷原始現有檔案中遵循新 EOS的任何位元組。
言論
SaveToFile 可用來將 Stream 物件的內容複製到本機檔案。 Stream 物件的內容或屬性沒有任何變更。 呼叫 SaveToFile 之前,必須先開啟 Stream 物件。
這個方法不會將 Stream 對象的關聯變更為其基礎來源。 Stream 物件仍會與開啟來源的原始 URL 或 Record 相關聯。
在 SaveToFile 作業之後,數據流中的目前位置 (Position) 會設定為數據流的開頭 (0)。