FireDAC.Comp.DataSet.TFDBlobStream.Write
Delphi
function Write(const ABuffer; ACount: Longint): Longint; override;
function Write(const ABuffer: TBytes; AOffset, ACount: Longint): Longint; override;
C++
virtual System::LongInt __fastcall Write(const void *ABuffer, System::LongInt ACount)/* overload */;
virtual System::LongInt __fastcall Write(const System::Sysutils::TBytes ABuffer, System::LongInt AOffset, System::LongInt ACount)/* overload */;
inline System::LongInt __fastcall Write(const System::Sysutils::TBytes Buffer, System::LongInt Count){ return System::Classes::TStream::Write(Buffer, Count); }
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp |
FireDAC.Comp.DataSet | TFDBlobStream |
Beschreibung
Schreibt die mit Count vorgegebene Anzahl von Bytes aus dem Puffer (Buffer) an die aktuelle Position im Speicherpuffer und aktualisiert dann die Position auf Basis von Count.
FireDAC.Comp.DataSet.TFDBlobStream.Write erbt von System.Classes.TMemoryStream.Write. Der folgende Inhalt bezieht sich auf System.Classes.TMemoryStream.Write.
Schreibt die mit Count vorgegebene Anzahl von Bytes aus dem Puffer (Buffer) an die aktuelle Position im Speicherpuffer und aktualisiert dann die Position auf Basis von Count.
Mit Write werden, beginnend an der aktuellen Position, so viele Bytes in den Speicherpuffer des Streams geschrieben, wie in Count vorgegeben. Falls nötig, wird der Speicherpuffer dabei vergrößert. Alle Daten, die nach der aktuellen Position (Startposition) stehen, werden überschrieben, wenn der Vorgang nicht am Ende des Speicherpuffers startet.
Write aktualisiert die Eigenschaft Size mit dem Wert Position + Count, und die Eigenschaft Position erhält den neuen Wert von Size. Somit gehen bei einem Aufruf von Write alle Daten verloren, die im Speicher-Stream nach der aktuellen Position gespeichert waren.
Write schreibt immer die in Count festgelegte Anzahl von Bytes in den Puffer, wenn kein Speicherfehler auftritt. Demnach ist Write für ein TMemoryStream-Objekt das Äquivalent zur Methode WriteBuffer.
Alle anderen Methoden des Speicher-Streams, die das Lesen von Daten ermöglichen (WriteBuffer, WriteComponent), rufen zum Schreiben Write auf.