FireDAC.Comp.DataSet.TFDDataSet.CreateBlobStream

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function CreateBlobStream(Field: TField; Mode: TBlobStreamMode): TStream; override;

C++

virtual System::Classes::TStream* __fastcall CreateBlobStream(Data::Db::TField* Field, Data::Db::TBlobStreamMode Mode);

Propriétés

Type Visibilité  Source Unité  Parent
function public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Description

Propose l'interface d'une méthode qui crée un flux blob pour un champ BLOB de l'ensemble de données.

FireDAC.Comp.DataSet.TFDDataSet.CreateBlobStream hérite de Data.DB.TDataSet.CreateBlobStream. Tout le contenu en-dessous de cette ligne se réfère à Data.DB.TDataSet.CreateBlobStream.

Propose l'interface d'une méthode qui crée un flux blob pour un champ BLOB de l'ensemble de données.

Appelez la méthode CreateBlobStream pour obtenir un flux permettant de lire et d'écrire la valeur du champ spécifié par le paramètre Field. Le paramètre Mode indique si le flux va lire la valeur du champ (bmRead), l'écrire (bmWrite), ou les deux (bmReadWrite).

Les flux Blob sont créés dans un mode particulier pour un champ particulier sur un enregistrement particulier. Les applications créent un nouveau flux blob à chaque fois que l'enregistrement de l'ensemble de données change : ne réutilisez pas un flux blob existant.

Telle qu'implémentée dans TDataSet, CreateBlobStream renvoie toujours nil (Delphi) ou NULL (C++). Les descendants de TDataSet surchargent cette méthode pour créer le descendant de TStream qui lit et écrit les données BLOB dans le format utilisé par le type ensemble de données pour stocker les champs BLOB.

Conseil :  Il est préférable d'appeler CreateBlobStream plutôt que de créer un flux BLOB directement dans le code. Ceci permet d'assurer que le flux est approprié à l'ensemble de données et peut aussi assurer que les ensembles de données qui ne stockent pas toujours des données BLOB en mémoire lisent les données BLOB avant de créer le flux.

Voir aussi

Exemples de code