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 例外を生成します。