SaveToFile メソッドSaveToFile Method

バイナリ コンテンツを保存、 Streamファイル。Saves the binary contents of a Stream to a file.

構文Syntax

  
Stream.SaveToFile FileName, SaveOptions  

パラメーターParameters

FileNameFileName
A文字列先ファイルの完全修飾名を含む値の内容、 Streamが保存されます。A String value that contains the fully-qualified name of the file to which the contents of the Stream will be saved. 有効なローカルの場所に保存できますか、任意の場所に UNC の値を使用してアクセスが。You can save to any valid local location, or any location you have access to via a UNC value.

SaveOptionsSaveOptions
A SaveOptionsEnumによって新しいファイルを作成するかどうかを指定する値SaveToFileが既に存在しない場合、します。A SaveOptionsEnum value that specifies whether a new file should be created by SaveToFile, if it does not already exist. 既定値はadSaveCreateNotExistsします。Default value is adSaveCreateNotExists. これらのオプションでは、指定したファイルが存在しない場合にエラーが発生したことを指定できます。With these options you can specify that an error occurs if the specified file does not exist. 指定することもできますSaveToFile既存のファイルの現在の内容が上書きされます。You can also specify that SaveToFile overwrites the current contents of an existing file.

注意

既存のファイルを上書きする場合 (とadSaveCreateOverwrite設定されている)、 SaveToFile新しいに続く元の既存のファイルからバイトを切り捨てますEOSします。If you overwrite an existing file (when adSaveCreateOverwrite is set), SaveToFile truncates any bytes from the original existing file that follow the new EOS.

コメントRemarks

SaveToFileの内容のコピーに使用できる、 Streamオブジェクトをローカル ファイルにします。SaveToFile may be used to copy the contents of a Stream object to a local file. 内容、またはプロパティの変更はありません、 Streamオブジェクト。There is no change in the contents or properties of the Stream object. Streamオブジェクトが呼び出す前に開く必要がありますSaveToFileします。The Stream object must be open before calling SaveToFile.

このメソッドの関連付けを変更していない、 Stream基になるソース オブジェクト。This method does not change the association of the Stream object to its underlying source. Streamオブジェクトは元の URL に関連付けされますまたはレコード開かれたときにそのソースでした。The Stream object will still be associated with the original URL or Record that was its source when opened.

後に、 SaveToFile操作、現在の位置 (位置)、ストリームでは (0) のストリームの先頭に設定します。After a SaveToFile operation, the current position (Position) in the stream is set to the beginning of the stream (0).

適用対象Applies To

Stream オブジェクト (ADO)Stream Object (ADO)

関連項目See Also

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