CDBVariant 類別

發行項
10/12/2023

表示 MFC ODBC 類別的 Variant 資料類型。

語法

class CDBVariant

成員

公用建構函式

名稱	描述
CDBVariant：：CDBVariant	建構 `CDBVariant` 物件。

公用方法

名稱	描述
CDBVariant：：Clear	清除 `CDBVariant` 物件。

公用資料成員

名稱	描述
CDBVariant：：m_dwType	包含目前儲存值的資料類型。輸入 `DWORD`。

公用聯集成員

名稱	描述
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 利用三個成員函式中的物件： GetFieldValue 、 GetBookmark 和 SetBookmark 。例如， 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 會將設定 m_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	等位資料成員
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 會產生不可靠的結果。

另請參閱

階層架構圖表
 CRecordset 類別

共用方式為