CLongBinary クラス

データベース上の大きなバイナリ データ オブジェクト (BLOB または "バイナリ ラージ オブジェクト" と呼びます) を使った作業を単純にします。

構文

class CLongBinary : public CObject

メンバー

パブリック コンストラクター

名前	説明
CLongBinary::CLongBinary	CLongBinary オブジェクトを構築します。

パブリック データ メンバー

名前	説明
CLongBinary::m_dwDataLength	ハンドルが格納されているデータ オブジェクトの実際のサイズをバイト単位で m_hData格納します。
CLongBinary::m_hData	実際のイメージ オブジェクトに対する Windows HGLOBAL ハンドルが含まれています。

解説

たとえば、SQL テーブルのレコード フィールドには、図を表すビットマップが含まれている場合があります。 オブジェクトは CLongBinary 、このようなオブジェクトを格納し、そのサイズを追跡します。

Note

一般に、DFX_Binary関数と組み合わせて CByteArray を使用することをお勧めします。 引き続き使用CLongBinaryできますが、16 ビットCByteArrayではサイズの制限が発生しなくなったため、一般CByteArrayに Win32 ではより多くの機能が提供されます。 このアドバイスは、Data Access オブジェクト (DAO) および Open Database Connectivity (ODBC) を使用したプログラミングに適用されます。

オブジェクトを CLongBinary 使用するには、レコードセット クラスで型 CLongBinary のフィールド データ メンバーを宣言します。 このメンバーは、レコードセット クラスの埋め込みメンバーになり、レコードセットが構築されるときに構築されます。 オブジェクトが CLongBinary 構築されると、レコード フィールド交換 (RFX) メカニズムは、データ ソースの現在のレコードのフィールドからデータ オブジェクトを読み込み、レコードが更新されたときにレコードに格納し直します。 RFX は、データ ソースにバイナリ ラージ オブジェクトのサイズを照会し、そのオブジェクトに (オブジェクトのm_hDataデータ メンバーをCLongBinary介して) ストレージを割り当て、データm_hDataへのハンドルを格納HGLOBALします。 RFX では、データ オブジェクトの実際のサイズもデータ メンバーに m_dwDataLength 格納されます。 Windows HGLOBAL ハンドルに格納されているデータの操作に通常使用するのと同じ手法を使用して、オブジェクトm_hData内のデータを操作します。

レコードセットを破棄すると、埋め込み CLongBinary オブジェクトも破棄され、そのデストラクターによってデータ ハンドルの HGLOBAL 割り当てが解除されます。

ラージ オブジェクトの詳細と使用方法 CLongBinaryの詳細については、「 Recordset (ODBC) 」および 「Recordset: Working with Large Data Items (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 クラス