Classe CLongBinary
Semplifica l'utilizzo di oggetti dati binari di grandi dimensioni (spesso chiamati BLOB) in un database.
Sintassi
class CLongBinary : public CObject
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CLongBinary::CLongBinary | Costruisce un oggetto CLongBinary. |
Membri dati pubblici
| Nome | Descrizione |
|---|---|
| CLongBinary::m_dwDataLength | Contiene le dimensioni effettive in byte dell'oggetto dati il cui handle viene archiviato in m_hData. |
| CLongBinary::m_hData | Contiene un handle HGLOBAL di Windows per l'oggetto immagine effettivo. |
Osservazioni:
Ad esempio, un campo di record in una tabella SQL può contenere una bitmap che rappresenta un'immagine. Un CLongBinary oggetto archivia tale oggetto e tiene traccia delle relative dimensioni.
Nota
In generale, è consigliabile usare CByteArray insieme alla funzione DFX_Binary . È comunque possibile usare CLongBinary, ma in generale CByteArray offre più funzionalità in Win32, poiché non esiste più la limitazione delle dimensioni rilevata con 16 bit CByteArray. Questo consiglio si applica alla programmazione con DAO (Data Access Objects) e ODBC (Open Database Connectivity).
Per usare un CLongBinary oggetto , dichiarare un membro dati di campo di tipo CLongBinary nella classe recordset. Questo membro sarà un membro incorporato della classe recordset e verrà costruito quando viene costruito il recordset. Dopo aver costruito l'oggetto CLongBinary , il meccanismo RFX (Record Field Exchange) carica l'oggetto dati da un campo nel record corrente nell'origine dati e lo archivia al record quando il record viene aggiornato. RFX esegue una query sull'origine dati per le dimensioni dell'oggetto binario di grandi dimensioni, alloca lo spazio di archiviazione (tramite il CLongBinary membro dati dell'oggetto m_hData ) e archivia un HGLOBAL handle per i dati in m_hData. RFX archivia anche le dimensioni effettive dell'oggetto dati nel m_dwDataLength membro dati. Usare i dati nell'oggetto tramite m_hData, usando le stesse tecniche usate normalmente per modificare i dati archiviati in un handle di Windows HGLOBAL .
Quando si elimina il recordset, l'oggetto incorporato CLongBinary viene eliminato definitivamente e il relativo distruttore dealloca l'handle HGLOBAL di dati.
Per altre informazioni sugli oggetti di grandi dimensioni e sull'uso di CLongBinary, vedere gli articoli Recordset (ODBC) e Recordset: Utilizzo di elementi di dati di grandi dimensioni (ODBC).
Gerarchia di ereditarietà
CLongBinary
Requisiti
Intestazione: afxdb_.h
CLongBinary::CLongBinary
Costruisce un oggetto CLongBinary.
CLongBinary();
CLongBinary::m_dwDataLength
Archivia le dimensioni effettive in byte dei dati archiviati nell'handle HGLOBAL in m_hData.
SQLULEN m_dwDataLength;
Osservazioni:
Queste dimensioni possono essere inferiori alle dimensioni del blocco di memoria allocato per i dati. Chiamare la funzione Win32 GLobalSize per ottenere le dimensioni allocate.
CLongBinary::m_hData
Archivia un handle HGLOBAL di Windows per i dati di oggetti binari di grandi dimensioni effettivi.
HGLOBAL m_hData;