CDBVariant クラス

MFC ODBC クラスのバリアント型を表します。

構文

class CDBVariant

メンバー

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

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

パブリック メソッド

名前 説明
CDBVariant::Clear CDBVariant オブジェクトをクリアします。

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

名前 説明
CDBVariant::m_dwType 現在格納されている値のデータ型を格納します。 「DWORD.

Public Union メンバー

名前 説明
CDBVariant::m_boolVal BOOLの値を格納します。
CDBVariant::m_chVal unsigned charの値を格納します。
CDBVariant::m_dblVal doubleの値を格納します。
CDBVariant::m_fltVal floatの値を格納します。
CDBVariant::m_iVal shortの値を格納します。
CDBVariant::m_lVal longの値を格納します。
CDBVariant::m_pbinary CLongBinaryのオブジェクトへのポインターを格納します。
CDBVariant::m_pdate TIMESTAMP_STRUCTのオブジェクトへのポインターを格納します。
CDBVariant::m_pstring CStringのオブジェクトへのポインターを格納します。
CDBVariant::m_pstringA ASCII CString オブジェクトへのポインターを格納します。
CDBVariant::m_pstringW ワイド CString オブジェクトへのポインターを格納します。

解説

CDBVariant には基底クラスはありません。

CDBVariantは COleVariant似ていますが、 CDBVariant OLE は使用しません。 CDBVariant を使用すると、値のデータ型を気にせずに値を格納できます。 CDBVariant が、現在の値のデータ型を追跡します。このデータ型は、共用体に格納されます。

クラス CRecordset は、次の CDBVariant 3 つのメンバー関数のオブジェクトを利用します。 GetFieldValueGetBookmarkSetBookmark たとえば、 GetFieldValue 列内のデータを動的にフェッチできます。 列のデータ型は実行時に不明な場合があるため、 GetFieldValue オブジェクトを CDBVariant 使用して列のデータを格納します。

継承階層

CDBVariant

必要条件

ヘッダー: afxdb.h

CDBVariant::CDBVariant

NULL CDBVariant オブジェクトを作成します。

CDBVariant();

解説

m_dwType データ メンバーを DBVT_NULL に設定します。

CDBVariant::Clear

オブジェクトをクリアするには、このメンバー関数を CDBVariant 呼び出します。

void Clear();

解説

m_dwType データ メンバーの値がDBVT_DATE、DBVT_STRING、またはDBVT_BINARYの場合は、Clear共用体ポインター メンバーに関連付けられているメモリを解放します。 Clear がDBVT_NULLに設定 m_dwType されます。

デストラクターが CDBVariant 呼び出します Clear

CDBVariant::m_boolVal

BOOL 型の値を格納します。

解説

データ メンバーは m_boolVal 共用体に属しています。 アクセスする前にm_boolVal、まず CDBVariant::m_dwType の値をチェックします。 DBVT_BOOLに設定されている場合、m_boolVal有効な値が含まれます。それ以外の場合m_dwType、アクセスするとm_boolVal信頼性の低い結果が生成されます。

CDBVariant::m_chVal

型の値を格納します unsigned char

解説

データ メンバーは m_chVal 共用体に属しています。 アクセスする前にm_chVal、まず CDBVariant::m_dwType の値をチェックします。 DBVT_UCHARに設定されている場合は、m_chVal有効な値が含まれます。それ以外の場合m_dwType、アクセスするとm_chVal信頼性の低い結果が生成されます。

CDBVariant::m_dblVal

型の値を格納します double

解説

データ メンバーは m_dblVal 共用体に属しています。 アクセスする前にm_dblVal、まず CDBVariant::m_dwType の値をチェックします。 DBVT_DOUBLEに設定されている場合は、m_dblVal有効な値が含まれます。それ以外の場合m_dwType、アクセスするとm_dblVal信頼性の低い結果が生成されます。

CDBVariant::m_dwType

このデータ メンバーには、オブジェクトの共用体データ メンバーに CDBVariant 現在格納されている値のデータ型が含まれています。

解説

この共用体にアクセスする前に、どの共用体データ・メンバーにアクセスするかを判別するために、値m_dwTypeをチェックする必要があります。 次の表に、使用可能な値 m_dwType と、対応する共用体データ メンバーを示します。

m_dwType Union データ メンバー
DBVT_NULL 共用体メンバーはアクセスに対して有効ではありません。
DBVT_BOOL m_boolVal
DBVT_UCHAR m_chVal
DBVT_SHORT m_iVal
DBVT_LONG m_lVal
DBVT_SINGLE m_fltVal
DBVT_DOUBLE m_dblVal
DBVT_DATE m_pdate
DBVT_STRING m_pstring
DBVT_BINARY m_pbinary
DBVT_ASTRING m_pstringA
DBVT_WSTRING m_pstringW

CDBVariant::m_fltVal

型の値を格納します float

解説

データ メンバーは m_fltVal 共用体に属しています。 アクセスする前にm_fltVal、まず CDBVariant::m_dwType の値をチェックします。 DBVT_SINGLEに設定されている場合は、m_fltVal有効な値が含まれます。それ以外の場合m_dwType、アクセスするとm_fltVal信頼性の低い結果が生成されます。

CDBVariant::m_iVal

型の値を格納します short

解説

データ メンバーは m_iVal 共用体に属しています。 アクセスする前にm_iVal、まず CDBVariant::m_dwType の値をチェックします。 DBVT_SHORTに設定されている場合は、m_iVal有効な値が含まれます。それ以外の場合m_dwType、アクセスするとm_iVal信頼性の低い結果が生成されます。

CDBVariant::m_lVal

型の値を格納します long

解説

データ メンバーは m_lVal 共用体に属しています。 アクセスする前にm_lVal、まず CDBVariant::m_dwType の値をチェックします。 DBVT_LONGに設定されている場合は、m_lVal有効な値が含まれます。それ以外の場合m_dwType、アクセスするとm_lVal信頼性の低い結果が生成されます。

CDBVariant::m_pbinary

CLongBinary 型 のオブジェクトへのポインターを格納します

解説

データ メンバーは m_pbinary 共用体に属しています。 アクセスする前にm_pbinary、まず CDBVariant::m_dwType の値をチェックします。 DBVT_BINARYに設定されている場合は、m_pbinary有効なポインターが含まれます。それ以外の場合m_dwType、アクセスするとm_pbinary信頼性の低い結果が生成されます。

CDBVariant::m_pdate

TIMESTAMP_STRUCT型のオブジェクトへのポインターを格納します。

解説

データ メンバーは m_pdate 共用体に属しています。 アクセスする前にm_pdate、まず CDBVariant::m_dwType の値をチェックします。 DBVT_DATEに設定されている場合は、m_pdate有効なポインターが含まれます。それ以外の場合m_dwType、アクセスするとm_pdate信頼性の低い結果が生成されます。

TIMESTAMP_STRUCTデータ型の詳細については、Windows SDK の ODBC プログラマ リファレンスの付録 D の C データ型に関するトピックを参照してください。

CDBVariant::m_pstring

CStringのオブジェクトへのポインターを格納します。

解説

データ メンバーは m_pstring 共用体に属しています。 アクセスする前にm_pstring、まず CDBVariant::m_dwType の値をチェックします。 DBVT_STRINGに設定されている場合は、m_pstring有効なポインターが含まれます。それ以外の場合m_dwType、アクセスするとm_pstring信頼性の低い結果が生成されます。

CDBVariant::m_pstringA

ASCII CString オブジェクトへのポインターを格納します。

解説

データ メンバーは m_pstringA 共用体に属しています。 アクセスする前にm_pstringA、まず CDBVariant::m_dwType の値をチェックします。 DBVT_ASTRINGに設定されている場合は、m_pstringA有効なポインターが含まれます。それ以外の場合m_dwType、アクセスするとm_pstringA信頼性の低い結果が生成されます。

CDBVariant::m_pstringW

ワイド CString オブジェクトへのポインターを格納します。

解説

データ メンバーは m_pstringW 共用体に属しています。 アクセスする前にm_pstringW、まず CDBVariant::m_dwType の値をチェックします。 DBVT_WSTRINGに設定されている場合は、m_pstringW有効なポインターが含まれます。それ以外の場合m_dwType、アクセスするとm_pstringW信頼性の低い結果が生成されます。

関連項目

階層図
CRecordset クラス