Datasnap.DBClient.TClientBlobStream

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

System.Classes.TMemoryStreamSystem.Classes.TCustomMemoryStreamSystem.Classes.TStreamSystem.TObjectTClientBlobStream

Delphi

TClientBlobStream = class(TMemoryStream)

C++

class PASCALIMPLEMENTATION TClientBlobStream : public System::Classes::TMemoryStream

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
class public
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient Datasnap.DBClient

Beschreibung

TClientBlobStream ermöglicht den Lese- und Schreibzugriff auf die BLOB-Felder einer Client-Datenmenge.

Mit TClientBlobStream können Sie auf die Werte von BLOB-Feldern in einer Client-Datenmenge zugreifen. BLOB-Felder sind Objekte der Klasse TBlobField und ihrer Nachkommen, z.B. TGraphicField und TMemoField. BLOB-Felder in Client-Datenmengen implementieren viele ihrer Datenzugriffseigenschaften und -methoden mit Hilfe von Client-BLOB-Streams.

Die Klasse TClientBlobStream stellt ein einheitliches Stream-Interface zur Verfügung. Objekte dieser Klasse können ohne spezielle Kenntnis der internen Verwaltung eines BLOB-Feldes auf dessen Daten zugreifen.

Wenn Sie ein TClientBlobStream-Objekt verwenden, gehen Sie in drei Schritten vor. Zuerst erstellen Sie eine Instanz von TClientBlobStream. Anschließend verwenden Sie ihre Methoden zum Lesen und Schreiben der Daten. Am Ende geben Sie die Instanz wieder frei. Verwenden Sie eine Instanz von TClientBlobStream aber auf keinen Fall für mehr als einen Datensatz. Erstellen Sie stattdessen für den Zugriff auf jeden weiteren Datensatz ein neues TClientBlobStream-Objekt.

Anmerkung:  Das explizite Erstellen einer TClientBlobStream-Instanz gewährleistet nicht, dass der aktuelle Datensatz seine BLOB-Daten abgerufen hat. Um vor dem Lesen aus dem BLOB-Stream sicherzustellen, dass das BLOB-Feld Daten enthält, sollten Sie die Methode FetchBlobs der Client-Datenmenge vor dem Erzeugen des BLOB-Streams aufrufen oder mit der Methode CreateBlobStream der Client-Datenmenge den BLOB-Stream indirekt erzeugen.

Siehe auch