Bde.DBTables.TBlobStream.Write

Übergeordnet: TBlobStream

Delphi

function Write(const Buffer; Count: Longint): Longint; override;

C++

virtual int __fastcall Write(const void *Buffer, int Count)/* overload */;
inline int __fastcall  Write(const System::DynamicArray<System::Byte> Buffer, int Offset, int Count){ return System::Classes::TStream::Write(Buffer, Offset, Count); }
inline int __fastcall  Write(const System::DynamicArray<System::Byte> Buffer, int Count){ return System::Classes::TStream::Write(Buffer, Count); }

Eigenschaften

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

Beschreibung

Schreibt Count Bytes aus Buffer an der aktuellen Position in das Feld und aktualisiert die Positionsangabe.

Mit Write können Sie Count Bytes an der aktuellen Position in das BLOB-Feld schreiben. Der Wert von Count wird immer genau berücksichtigt, weil BLOB-Daten nicht unbedingt ein abschließendes Endezeichen haben müssen. Somit sind Write und WriteBuffer äquivalent.

Buffer ist der Zielcontainer für Write 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 Puffer in das BLOB-Feld übertragen, 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.

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

Die Methode Write wird von allen anderen Schreibmethoden eines BLOB-Streams (WriteBuffer, WriteComponent) aufgerufen und führt den eigentlichen Schreibvorgang durch.