Поделиться через


Класс CLongBinary

Упрощает работу с очень большими объектами двоичных данных (BLOB-объектами) в базе данных.

Синтаксис

class CLongBinary : public CObject

Участники

Открытые конструкторы

Имя Описание
CLongBinary::CLongBinary Формирует объект CLongBinary.

Открытые члены данных

Имя Описание
CLongBinary::m_dwDataLength Содержит фактический размер в байтах объекта данных, дескриптор которого хранится в m_hData.
CLongBinary::m_hData Содержит дескриптор Windows HGLOBAL для фактического объекта изображения.

Замечания

Например, поле записи в таблице SQL может содержать растровое изображение, представляющее рисунок. Объект CLongBinary хранит такой объект и отслеживает его размер.

Примечание.

Как правило, теперь рекомендуется использовать CByteArray вместе с функцией DFX_Binary . Вы по-прежнему можете использовать CLongBinary, но в целом CByteArray предоставляет более функциональные возможности в win32, так как больше нет ограничения размера, обнаруженного с 16-разрядной версией CByteArray. Этот совет относится к программированию с помощью объектов доступа к данным (DAO), а также open Database Connectivity (ODBC).

Чтобы использовать CLongBinary объект, объявите элемент данных поля типа CLongBinary в классе наборов записей. Этот элемент будет внедренным членом класса набора записей и будет создан при создании набора записей. CLongBinary После создания объекта механизм обмена полями записей (RFX) загружает объект данных из поля в текущей записи источника данных и сохраняет его обратно в запись при обновлении записи. RFX запрашивает источник данных для размера двоичного большого объекта, выделяет для него хранилище (через CLongBinary член данных объекта m_hData ) и сохраняет дескриптор HGLOBAL данных в m_hData. RFX также сохраняет фактический размер объекта данных в элементе m_dwDataLength данных. Работа с данными в объекте m_hData, используя те же методы, которые обычно используются для управления данными, хранящимися в дескрипторе Windows HGLOBAL .

При уничтожении набора записей внедренный CLongBinary объект также уничтожается, а его деструктор освобождает HGLOBAL деструктор обработки данных.

Дополнительные сведения о больших объектах и использовании CLongBinaryсм. в статьях Recordset (ODBC) и Recordset: работа с большими элементами данных (ODBC).

Иерархия наследования

CObject

CLongBinary

Требования

Заголовок: afxdb_.h

CLongBinary::CLongBinary

Формирует объект CLongBinary.

CLongBinary();

CLongBinary::m_dwDataLength

Сохраняет фактический размер в байтах данных, хранящихся в дескрипторе m_hDataHGLOBAL.

SQLULEN m_dwDataLength;

Замечания

Этот размер может быть меньше размера блока памяти, выделенного для данных. Вызовите функцию Win32 GLobalSize , чтобы получить выделенный размер.

CLongBinary::m_hData

Сохраняет дескриптор Windows HGLOBAL для фактических данных больших двоичных объектов.

HGLOBAL m_hData;

См. также

Класс CObject
Диаграмма иерархии
Класс CRecordset