SaveToFile メソッド

  • [アーティクル]

Stream のバイナリ コンテンツをファイルに保存します。

構文

  
Stream.SaveToFile FileName, SaveOptions

パラメーター

FileName
Stream の内容が保存されるファイルの完全修飾名を含むString値。 有効な任意のローカルの場所、または UNC 値を使用してアクセスできる任意の場所に保存できます。

SaveOptions
新しいファイルを、まだ存在しない場合に SaveToFile で作成するかどうかを指定する SaveOptionsEnum 値。 既定値は adSaveCreateNotExists です。 これらのオプションを使用して、指定したファイルが存在しない場合にエラーが発生することを指定できます。 SaveToFile が既存のファイルの現在の内容を上書きすることを指定することもできます。

注意

既存のファイルを上書きする場合 (adSaveCreateOverwrite が設定されているとき)、SaveToFile は元の既存のファイルの、新しい EOS に続くバイトを切り捨てます。

注釈

SaveToFile を使用して Stream オブジェクトの内容をローカル ファイルにコピーできます。 Stream オブジェクトの内容やプロパティに変化はありません。 Stream オブジェクトは、SaveToFile を呼び出す前に開いていなければなりません。

このメソッドは、Stream オブジェクトとその基になるソースとの関連付けを変更しません。 Stream オブジェクトは、開いたときにそのソースであった元の URL またはレコードにまだ関連付けられています。

SaveToFile 操作の後、ストリーム内の現在の位置 (Position) はストリームの先頭 (0) に設定されます。

適用対象

Stream オブジェクト (ADO)

参照

Open メソッド (ADO Stream)
Save メソッド