Bde.DBTables.TBlobStream.Read

Übergeordnet: TBlobStream

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); }

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	Bde.DBTables.pas Bde.DBTables.hpp	Bde.DBTables	TBlobStream

Beschreibung

Liest, beginnend an der aktuellen Position, so viele Bytes in den Puffer (Buffer), wie von Count vorgegeben.

Mit Read können Daten aus dem BLOB-Feld gelesen werden, wenn die Byte-Anzahl der Felddaten nicht bekannt ist.

Buffer ist der Zielcontainer für Read und muss den Typ PChar (Delphi), char* (C++) oder einen äquivalenten Typ aufweisen. Die Puffergröße muss mindestens dem Wert von Count entsprechen, damit alle gelesenen Daten Platz finden. Beginnend an der aktuellen Position, werden maximal so viele Bytes aus dem BLOB-Stream in den Puffer gelesen, wie mit Count angegeben. Anschließend wird die aktuelle Position an die tatsächlich übertragene Byte-Anzahl angepasst. Diese Anzahl wird zurückgegeben. Sie ist eventuell kleiner als der Wert von Count.

Read überprüft die Eigenschaft Transliterate des Feldes. Wenn diese den Wert True hat, werden alle Daten vom ANSI-Code in den Zeichensatz konvertiert, den die Datenmenge erfordert.

Alle anderen Methoden eines BLOB-Feldes zum Lesen von Daten (ReadBuffer, ReadComponent) rufen Read für den eigentlichen Lesevorgang auf.