CDBVariant osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az MFC ODBC-osztályok variáns adattípusát jelöli.

Szemantika

class CDBVariant

Tagok

Nyilvános konstruktorok

Név	Description
CDBVariant::CDBVariant	Egy CDBVariant objektumot hoz létre.

Nyilvános metódusok

Név	Description
CDBVariant::Clear	Törli az objektumot CDBVariant .

Nyilvános adatok tagjai

Név	Description
CDBVariant::m_dwType	A jelenleg tárolt érték adattípusát tartalmazza. Gépelje be: DWORD.

Közunió tagjai

Név	Description
CDBVariant::m_boolVal	BOOL típusú értéket tartalmaz.
CDBVariant::m_chVal	Típusértéket unsigned chartartalmaz.
CDBVariant::m_dblVal	Típusértéket doubletartalmaz.
CDBVariant::m_fltVal	Típusértéket floattartalmaz.
CDBVariant::m_iVal	Típusértéket shorttartalmaz.
CDBVariant::m_lVal	Típusértéket longtartalmaz.
CDBVariant::m_pbinary	Egy mutatót tartalmaz egy típusú CLongBinaryobjektumra.
CDBVariant::m_pdate	Egy TIMESTAMP_STRUCT típusú objektumra mutató mutatót tartalmaz.
CDBVariant::m_pstring	Egy mutatót tartalmaz egy típusú CStringobjektumra.
CDBVariant::m_pstringA	Egy ASCII CString objektumra mutató mutatót tárol.
CDBVariant::m_pstringW	Egy széles CString-objektumra mutató mutatót tárol.

Megjegyzések

CDBVariant nem rendelkezik alaposztálysal.

CDBVariant hasonló a COleVarianthoz; CDBVariant azonban nem használja az OLE-t. CDBVariant lehetővé teszi az érték tárolását anélkül, hogy aggódnia kellene az érték adattípusa miatt. CDBVariant nyomon követi az aktuális érték adattípusát, amely egy egyesítésben van tárolva.

A CRecordset osztály három tagfüggvény objektumait CDBVariant használja: GetFieldValue, GetBookmarkés SetBookmark. Lehetővé teszi például az GetFieldValue adatok dinamikus beolvasását egy oszlopban. Mivel az oszlop adattípusa futásidőben nem ismert, GetFieldValue egy objektummal CDBVariant tárolja az oszlop adatait.

Öröklési hierarchia

CDBVariant

Requirements

Fejléc: afxdb.h

CDBVariant::CDBVariant

NULL CDBVariant objektumot hoz létre.

CDBVariant();

Megjegyzések

Beállítja a m_dwType adattagot DBVT_NULL.

CDBVariant::Clear

Az objektum törléséhez hívja meg ezt a tagfüggvényt CDBVariant .

void Clear();

Megjegyzések

Ha a m_dwType adattag értéke DBVT_DATE, DBVT_STRING vagy DBVT_BINARY, Clear felszabadítja az egyesítő mutató taghoz társított memóriát. Clear DBVT_NULL értékre állítja m_dwType .

A CDBVariant destruktor hív Clear.

CDBVariant::m_boolVal

A BOOL típusú értéket tárolja.

Megjegyzések

Az m_boolVal adattag egy unióhoz tartozik. A hozzáférés m_boolValelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_BOOL értékre van állítva, akkor m_boolVal érvényes értéket fog tartalmazni; ellenkező esetben a hozzáférés m_boolVal megbízhatatlan eredményeket eredményez.

CDBVariant::m_chVal

Típusértéket unsigned chartárol.

Megjegyzések

Az m_chVal adattag egy unióhoz tartozik. A hozzáférés m_chValelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_UCHAR van beállítva, akkor m_chVal érvényes értéket tartalmaz; ellenkező esetben a hozzáférés m_chVal megbízhatatlan eredményeket eredményez.

CDBVariant::m_dblVal

Típusértéket doubletárol.

Megjegyzések

Az m_dblVal adattag egy unióhoz tartozik. A hozzáférés m_dblValelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_DOUBLE értékre van állítva, akkor m_dblVal érvényes értéket tartalmaz; ellenkező esetben a hozzáférés m_dblVal megbízhatatlan eredményeket eredményez.

CDBVariant::m_dwType

Ez az adattag az objektum egyesítő adattagjában CDBVariant jelenleg tárolt érték adattípusát tartalmazza.

Megjegyzések

Az unió elérése előtt ellenőriznie kell annak értékét m_dwType , hogy melyik uniós adattaghoz fér hozzá. Az alábbi táblázat felsorolja a lehetséges értékeket m_dwType és a megfelelő uniós adattagot.

m_dwType	Uniós adattag
DBVT_NULL	Egyetlen szakszervezeti tag sem érvényes a hozzáférésre.
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

Típusértéket floattárol.

Megjegyzések

Az m_fltVal adattag egy unióhoz tartozik. A hozzáférés m_fltValelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_SINGLE értékre van állítva, akkor m_fltVal érvényes értéket tartalmaz; ellenkező esetben a hozzáférés m_fltVal megbízhatatlan eredményeket eredményez.

CDBVariant::m_iVal

Típusértéket shorttárol.

Megjegyzések

Az m_iVal adattag egy unióhoz tartozik. A hozzáférés m_iValelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_SHORT értékre van állítva, akkor m_iVal érvényes értéket tartalmaz; ellenkező esetben a hozzáférés m_iVal megbízhatatlan eredményeket eredményez.

CDBVariant::m_lVal

Típusértéket longtárol.

Megjegyzések

Az m_lVal adattag egy unióhoz tartozik. A hozzáférés m_lValelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_LONG értékre van állítva, akkor m_lVal érvényes értéket tartalmaz; ellenkező esetben a hozzáférés m_lVal megbízhatatlan eredményeket eredményez.

CDBVariant::m_pbinary

Egy CLongBinary típusú objektumra mutató mutatót tárol.

Megjegyzések

Az m_pbinary adattag egy unióhoz tartozik. A hozzáférés m_pbinaryelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_BINARY értékre van állítva, akkor m_pbinary érvényes mutatót tartalmaz, ellenkező esetben a hozzáférés m_pbinary megbízhatatlan eredményeket eredményez.

CDBVariant::m_pdate

Egy TIMESTAMP_STRUCT típusú objektumra mutató mutatót tárol.

Megjegyzések

Az m_pdate adattag egy unióhoz tartozik. A hozzáférés m_pdateelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_DATE értékre van állítva, akkor m_pdate érvényes mutatót tartalmaz, ellenkező esetben a hozzáférés m_pdate megbízhatatlan eredményeket eredményez.

A TIMESTAMP_STRUCT adattípussal kapcsolatos további információkért tekintse meg az ODBC Programozó Windows SDK-beli referenciájának D függelékében található C adattípusok című témakört.

CDBVariant::m_pstring

Egy CString típusú objektumra mutató mutatót tárol.

Megjegyzések

Az m_pstring adattag egy unióhoz tartozik. A hozzáférés m_pstringelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_STRING van beállítva, akkor m_pstring érvényes mutatót tartalmaz, ellenkező esetben a hozzáférés m_pstring megbízhatatlan eredményeket eredményez.

CDBVariant::m_pstringA

Egy ASCII CString objektumra mutató mutatót tárol.

Megjegyzések

Az m_pstringA adattag egy unióhoz tartozik. A hozzáférés m_pstringAelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_ASTRING értékre van állítva, akkor m_pstringA érvényes mutatót tartalmaz, ellenkező esetben a hozzáférés m_pstringA megbízhatatlan eredményeket eredményez.

CDBVariant::m_pstringW

Egy széles CString-objektumra mutató mutatót tárol.

Megjegyzések

Az m_pstringW adattag egy unióhoz tartozik. A hozzáférés m_pstringWelőtt először ellenőrizze a CDBVariant::m_dwType értékét. Ha m_dwType DBVT_WSTRING van beállítva, akkor m_pstringW érvényes mutatót tartalmaz, ellenkező esetben a hozzáférés m_pstringW megbízhatatlan eredményeket eredményez.

Lásd még

hierarchiadiagram
CRecordset osztály