SaveToFile 方法

將 Stream 的二進位內容儲存至檔案。

語法

  
Stream.SaveToFile FileName, SaveOptions  

參數

FileName
String 值，其中包含將儲存 Stream 內容的檔案完整名稱。 您可以儲存至任何有效的本機位置，或您可透過 UNC 值存取的任何位置。

SaveOptions
SaveOptionsEnum 值，指定如果新檔案尚未存在，是否應該由 SaveToFile 建立新檔案。 預設值為 adSaveCreateNotExists。 使用這些選項，您可以指定若指定的檔案不存在，就會發生錯誤。 您也可以指定 SaveToFile 會覆寫現有檔案的目前內容。

注意

如果您覆寫現有的檔案 (當 adSaveCreateOverwrite 設定時)，SaveToFile 會截斷原始現有檔案中遵循新 EOS 的任何位元組。

備註

SaveToFile 可用來將 Stream 物件的內容複寫到本機檔案。 Stream 物件的內容或屬性沒有任何變更。 在呼叫 SaveToFile 之前，必須先開啟 Stream 物件。

這個方法不會將 Stream 物件的關聯變更為其基礎來源。 Stream 物件仍會與開啟時的原始 URL 或 Record 相關聯。

SaveToFile 作業之後，資料流中目前的位置 (Position) 會設定為資料流開頭 (0)。

套用至

Stream 物件 (ADO)

另請參閱

Open 方法 (ADO Stream)
Save 方法