Partager via


CLongBinary, classe

Simplifie l'utilisation d'objets de données binaires de très grande taille (souvent appelés BLOB ou « objets blob ») dans une base de données.

Syntaxe

class CLongBinary : public CObject

Membres

Constructeurs publics

Nom Description
CLongBinary ::CLongBinary Construit un objet CLongBinary.

Membres de données publics

Nom Description
CLongBinary ::m_dwDataLength Contient la taille réelle en octets de l’objet de données dont le handle est stocké dans m_hData.
CLongBinary ::m_hData Contient un handle Windows HGLOBAL pour l’objet image réel.

Notes

Par exemple, un champ d’enregistrement dans une table SQL peut contenir une bitmap représentant une image. Un CLongBinary objet stocke un tel objet et suit sa taille.

Remarque

En général, il est préférable d’utiliser CByteArray conjointement avec la fonction DFX_Binary . Vous pouvez toujours utiliser CLongBinary, mais en général CByteArray fournit plus de fonctionnalités sous Win32, car il n’existe plus la limitation de taille rencontrée avec 16 bits CByteArray. Ces conseils s’appliquent à la programmation avec des objets d’accès aux données (DAO) ainsi qu’à Open Database Connectivity (ODBC).

Pour utiliser un CLongBinary objet, déclarez un membre de données de champ de type CLongBinary dans votre classe recordset. Ce membre sera un membre incorporé de la classe recordset et sera construit lorsque le jeu d’enregistrements est construit. Une fois l’objet CLongBinary construit, le mécanisme d’échange de champs d’enregistrement (RFX) charge l’objet de données à partir d’un champ dans l’enregistrement actif sur la source de données et le stocke dans l’enregistrement lorsque l’enregistrement est mis à jour. RFX interroge la source de données pour la taille de l’objet volumineux binaire, alloue du stockage pour celui-ci (via le membre de données de m_hData l’objetCLongBinary) et stocke un HGLOBAL handle dans les données.m_hData RFX stocke également la taille réelle de l’objet de données dans le membre de m_dwDataLength données. Utilisez les données de l’objet à m_hDatal’aide des mêmes techniques que celles que vous utilisez normalement pour manipuler les données stockées dans un handle Windows HGLOBAL .

Lorsque vous détruisez votre jeu d’enregistrements, l’objet incorporé CLongBinary est également détruit et son destructeur libère le HGLOBAL handle de données.

Pour plus d’informations sur les objets volumineux et l’utilisation de , consultez les articles Recordset (ODBC) et Recordset : Utilisation d’éléments CLongBinaryde données volumineux (ODBC)

Hiérarchie d'héritage

CObject

CLongBinary

Spécifications

En-tête : afxdb_.h

CLongBinary ::CLongBinary

Construit un objet CLongBinary.

CLongBinary();

CLongBinary ::m_dwDataLength

Stocke la taille réelle en octets des données stockées dans le handle HGLOBAL dans m_hData.

SQLULEN m_dwDataLength;

Notes

Cette taille peut être inférieure à la taille du bloc de mémoire alloué pour les données. Appelez la fonction Win32 GLobalSize pour obtenir la taille allouée.

CLongBinary ::m_hData

Stocke un handle Windows HGLOBAL sur les données d’objet volumineux binaires réelles.

HGLOBAL m_hData;

Voir aussi

CObject, classe
Graphique hiérarchique
CRecordset, classe