TECLBaseStream.LoadFromStream

TECLBaseStream

Loads the entire contents of a specified stream into the current stream.

procedure LoadFromStream(Stream: TStream);

Description

Use LoadFromStream to fill the current stream with the contents of the stream specified by the Stream parameter. LoadFromStream always sets the Position of the source stream to 0, before streaming in the number of bytes indicated by the source stream’s Size property.

LoadFromStream resets the size of current stream, so that the contents of the source stream will fit exactly. It sets the Size property accordingly, and then reads the entire contents of the source stream into the current stream. Thus, LoadFromStream will discard any pre-existing data stored in the current stream.

If the source stream is a TFileStream object, LoadFromStream does the same thing as LoadFromFile, except that the application must create and free the TFileStream object. LoadFromStream also allows applications to fill a current stream object from other types of stream objects.

Note:      We recommend that you use the LoadFromStream instead of the CopyFrom method as it works much faster.