Bde.DBTables.TBlobStream.Read

De RAD Studio API Documentation
Aller à : navigation, rechercher

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

Propriétés

Type Visibilité  Source Unité  Parent
function public
Bde.DBTables.pas
Bde.DBTables.hpp
Bde.DBTables TBlobStream


Description

Read lit jusqu'à Count octets à partir de la position en cours dans les données du champ et les écrit dans Buffer.

Appelez Read pour lire les données d'un champ BLOB quand le nombre d'octets des données du champ est inconnu.


Buffer est le conteneur cible pour Read et doit avoir pour type PChar (Delphi), char * (C++) ou un type équivalent. Au moins Count octets doivent être alloués dans Buffer pour stocker les données lues à partir du champ. Read transfère jusqu'à hauteur de Count octets des données du champ BLOB dans Buffer, en commençant à la position en cours, puis avance la position en cours du nombre d'octets effectivement transférés. Read renvoie le nombre d'octets effectivement transférés (qui peut être inférieur au nombre demandé Count).

Read lit la propriété Transliterate du champ et convertit les données en ANSI à partir du jeu de caractères spécifié par l'ensemble de données si Transliterate vaut true.

Toutes les autres méthodes de lecture de données d'un flux BLOB (Read Buffer, Read Component) appellent Read pour effectuer la lecture réelle.

Remarque : N'appelez pas Read lorsque le TBlobStream a été créé en mode bmWrite.

Voir aussi