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 は、GetFieldValue、GetBookmark、SetBookmarkの 3 つのメンバー関数のCDBVariant オブジェクトを利用します。 たとえば、 GetFieldValue では、列内のデータを動的にフェッチできます。 列のデータ型は実行時に不明な場合があるため、 GetFieldValue は CDBVariant オブジェクトを使用して列のデータを格納します。
継承階層
CDBVariant
要件
Header: 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は共用体ポインター メンバーに関連付けられているメモリを解放します。 Clearm_dwTypeをDBVT_NULLに設定します。
CDBVariantデストラクターはClearを呼び出します。
CDBVariant::m_boolVal
BOOL 型の値を格納します。
解説
m_boolVal データ メンバーは共用体に属しています。 m_boolValにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeが DBVT_BOOL に設定されている場合、m_boolValには有効な値が含まれます。それ以外の場合、m_boolValにアクセスすると信頼性の低い結果が生成されます。
CDBVariant::m_chVal
unsigned char型の値を格納します。
解説
m_chVal データ メンバーは共用体に属しています。 m_chValにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeがDBVT_UCHARに設定されている場合、m_chValには有効な値が含まれます。それ以外の場合、m_chValにアクセスすると、信頼性の低い結果が生成されます。
CDBVariant::m_dblVal
double型の値を格納します。
解説
m_dblVal データ メンバーは共用体に属しています。 m_dblValにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeが DBVT_DOUBLE に設定されている場合、m_dblValには有効な値が含まれます。それ以外の場合、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 の値を確認します。 m_dwTypeが DBVT_SINGLE に設定されている場合、m_fltValには有効な値が含まれます。それ以外の場合、m_fltValにアクセスすると信頼性の低い結果が生成されます。
CDBVariant::m_iVal
short型の値を格納します。
解説
m_iVal データ メンバーは共用体に属しています。 m_iValにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeが DBVT_SHORT に設定されている場合、m_iValには有効な値が含まれます。それ以外の場合、m_iValにアクセスすると信頼性の低い結果が生成されます。
CDBVariant::m_lVal
long型の値を格納します。
解説
m_lVal データ メンバーは共用体に属しています。 m_lValにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeが DBVT_LONG に設定されている場合、m_lValには有効な値が含まれます。それ以外の場合、m_lValにアクセスすると信頼性の低い結果が生成されます。
CDBVariant::m_pbinary
CLongBinary 型のオブジェクトへのポインターを格納します。
解説
m_pbinary データ メンバーは共用体に属しています。 m_pbinaryにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeがDBVT_BINARYに設定されている場合、m_pbinaryには有効なポインターが含まれます。それ以外の場合、m_pbinaryにアクセスすると信頼性の低い結果が生成されます。
CDBVariant::m_pdate
TIMESTAMP_STRUCT型のオブジェクトへのポインターを格納します。
解説
m_pdate データ メンバーは共用体に属しています。 m_pdateにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeが DBVT_DATE に設定されている場合、m_pdateには有効なポインターが含まれます。それ以外の場合、m_pdateにアクセスすると信頼性の低い結果が生成されます。
TIMESTAMP_STRUCTデータ型の詳細については、Windows SDK の「ODBC プログラマ リファレンスの付録 D のC データ型」を参照してください。
CDBVariant::m_pstring
CString 型のオブジェクトへのポインターを格納します。
解説
m_pstring データ メンバーは共用体に属しています。 m_pstringにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeが DBVT_STRING に設定されている場合、m_pstringには有効なポインターが含まれます。それ以外の場合、m_pstringにアクセスすると信頼性の低い結果が生成されます。
CDBVariant::m_pstringA
ASCII CString オブジェクトへのポインターを格納します。
解説
m_pstringA データ メンバーは共用体に属しています。 m_pstringAにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeが DBVT_ASTRING に設定されている場合、m_pstringAには有効なポインターが含まれます。それ以外の場合、m_pstringAにアクセスすると信頼性の低い結果が生成されます。
CDBVariant::m_pstringW
ワイド CString オブジェクトへのポインターを格納します。
解説
m_pstringW データ メンバーは共用体に属しています。 m_pstringWにアクセスする前に、まず CDBVariant::m_dwType の値を確認します。 m_dwTypeがDBVT_WSTRINGに設定されている場合、m_pstringWには有効なポインターが含まれます。それ以外の場合、m_pstringWにアクセスすると信頼性の低い結果が生成されます。