Bde.DBTables.TBlobStream.Read
Delphi
function Read(Buffer: TBytes; Offset, Count: Longint): Longint; overload; override;
function Read(var Buffer; Count: Longint): Longint; overload; override;
C++
virtual int __fastcall Read(System::DynamicArray<System::Byte> Buffer, int Offset, int Count)/* overload */;
virtual int __fastcall Read(void *Buffer, int Count)/* overload */;
inline int __fastcall Read(System::DynamicArray<System::Byte> &Buffer, int Count){ return System::Classes::TStream::Read(Buffer, Count); }
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TBlobStream |
Description
Reads up to Count bytes from the current position in the field's data into Buffer.
Call Read to read data from the BLOB field when the number of bytes in the field's data is not known.
Buffer is the target container for Read and must be of type PChar (Delphi), char * (C++), or equivalent. Buffer must have at least Count bytes allocated to hold the data that was read from the field. Read transfers up to Count bytes from the BLOB data into Buffer, starting in the current position, and then advances the current position by the number of bytes actually transferred. Read returns the number of bytes actually transferred (which may be less than the number requested in Count).
Read checks the Transliterate property of the field, and converts the data into ANSI from the character set specified by the dataset if Transliterate is true.
All the other data-reading methods of a BLOB stream (ReadBuffer, ReadComponent) call Read to do their actual reading.
Note: Do not call Read when the TBlobStream was created in bmWrite mode.