CLongBinary 類別

簡化在資料庫中對極大型二進位資料物件 (通常稱為 BLOB 或「二進位大型物件」) 的處理。

語法

class CLongBinary : public CObject

成員

公用建構函式

名稱	描述
CLongBinary：：CLongBinary	建構 CLongBinary 物件。

公用資料成員

名稱	描述
CLongBinary：：m_dwDataLength	包含資料物件的實際大小，其控制碼儲存在 中 m_hData 。
CLongBinary：：m_hData	包含實際影像物件的 Windows HGLOBAL 控制碼。

備註

例如，SQL 資料表中的記錄欄位可能包含代表圖片的點陣圖。 CLongBinary物件會儲存這類物件，並追蹤其大小。

注意

一般而言，現在最好搭配 DFX_Binary 函式使用 CByteArray 。 您仍然可以使用 CLongBinary ，但一般 CByteArray 在 Win32 下提供更多功能，因為不再有 16 位 CByteArray 所遇到的大小限制。 此建議適用于使用資料存取物件 （DAO） 以及開放式資料庫連線ivity （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

將儲存在 HGLOBAL 控制碼 m_hData 中之資料的實際大小，以位元組為單位。

SQLULEN m_dwDataLength;

備註

此大小可能小於配置給資料的記憶體區塊大小。 呼叫 Win32 GLobalSize 函式以取得配置的大小。

CLongBinary：：m_hData

將 Windows HGLOBAL 控制碼儲存至實際的二進位大型物件資料。

HGLOBAL m_hData;

另請參閱

CObject 類別
階層架構圖表
CRecordset 類別