[Overview][Types][Classes][Procedures and functions][Index] Reference for unit 'BufDataset' (#fcl)


Loads the dataset from the specified stream using the given data format


Source position: bufdataset.pas line 647

public procedure TCustomBufDataset.LoadFromStream(

  AStream: TStream;

  Format: TDataPacketFormat = dfDefault





Stream with values loaded into the dataset



Format expected in the stream


LoadFromStream is a procedure used to load field definitions and record data for the dataset from the specified stream. LoadFromStream is an overloaded variant of the method defined in the ancestor class and includes a parameter for the desired data packet format.

AStream is a TStream descendant with the values to load in the dataset. Format indicates the expected format for data packets in the stream. It is a variable argument that can be modified when a packet reader is located for the stream.

LoadFromStream calls CheckBiDirectional to ensure that the UniDirectional property in the dataset is set to False. An exception is raised when UniDirectional contains True. Index creation requires navigating in a non-default record order that would not be supported in a uni-directional dataset.

LoadFromStream creates a temporary TDataPacketReader class instance using the value specified in the Format argument. Format is a variable argument and can be modified when SetDatasetPacket is used to examine the packet reader and its stream. Calling SetDatasetPacket sets in motion a relatively complicated sequence of events that eventually get the field definitions and record data loaded into the dataset. The journey starts with Open.

LoadFromStream is used in the implementation of the LoadFromFile method.

See also



Indicates if the dataset is for uni-directional navigation only



Retrieves and applies the data packet with the content for the dataset



Loads the dataset from the specified file using the given format



Activate the dataset: Fetch data into memory.



Indicates the format used for data packets in TBufDataset

Documentation generated on: May 14 2021