System.Classes.TCustomMemoryStream.SaveToStream
Delphi
procedure SaveToStream(Stream: TStream); virtual;
C++
virtual void __fastcall SaveToStream(TStream* Stream);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TCustomMemoryStream |
説明
メモリストリームの全内容を Stream で指定するストリームオブジェクトに書き込みます。
SaveToStream メソッドを呼び出すと，メモリに格納されているデータを別の記憶媒体にコピーできます。SaveToStream メソッドは Memory の全内容を，パラメータとして渡したストリーム内の現在位置から，指定したストリームオブジェクトに書き込みます。
Stream パラメータに TFileStream オブジェクトを指定したときは，SaveToStream メソッドは SaveToFile メソッドとほぼ同じように動作します。ただし，SaveToStream メソッドは，ターゲットストリーム内の現在位置に書き込みを行います。したがって，SaveToStream メソッドは，たとえば Memory の内容をファイルストリームに追加するのに使用できますが，SaveToFile メソッドはファイルの内容を Memory の内容に置き換えるのに使用できます。
メモリストリームの全内容をターゲットストリームに書き込めない場合，SaveToStream メソッドは EWriteError 例外を生成します。