CDBVariant – třída

Představuje datový typ varianty pro třídy MFC ODBC.

Syntaxe

class CDBVariant

Členové

Veřejné konstruktory

Název	Popis
CDBVariant::CDBVariant	CDBVariant Vytvoří objekt.

Veřejné metody

Název	Popis
CDBVariant::Clear	Vymaže CDBVariant objekt.

Veřejné datové členy

Název	Popis
CDBVariant::m_dwType	Obsahuje datový typ aktuálně uložené hodnoty. Zadejte DWORD.

Členové veřejné unie

Název	Popis
CDBVariant::m_boolVal	Obsahuje hodnotu typu BOOL.
CDBVariant::m_chVal	Obsahuje hodnotu typu unsigned char.
CDBVariant::m_dblVal	Obsahuje hodnotu typu double.
CDBVariant::m_fltVal	Obsahuje hodnotu typu float.
CDBVariant::m_iVal	Obsahuje hodnotu typu short.
CDBVariant::m_lVal	Obsahuje hodnotu typu long.
CDBVariant::m_pbinary	Obsahuje ukazatel na objekt typu CLongBinary.
CDBVariant::m_pdate	Obsahuje ukazatel na objekt typu TIMESTAMP_STRUCT.
CDBVariant::m_pstring	Obsahuje ukazatel na objekt typu CString.
CDBVariant::m_pstringA	Uloží ukazatel na objekt ASCII CString .
CDBVariant::m_pstringW	Uloží ukazatel na široký objekt CString .

Poznámky

CDBVariant nemá základní třídu.

CDBVariantje podobný COleVariant, CDBVariant ale nepoužívá OLE. CDBVariant umožňuje ukládat hodnotu bez obav o datový typ hodnoty. CDBVariant sleduje datový typ aktuální hodnoty, která je uložena ve sjednocení.

Třída CRecordset využívá objekty CDBVariant ve třech členských funkcích: GetFieldValue, GetBookmarka SetBookmark. Umožňuje například GetFieldValue dynamicky načítat data ve sloupci. Vzhledem k tomu, že datový typ sloupce nemusí být znám za běhu, GetFieldValue používá CDBVariant objekt k uložení dat sloupce.

Hierarchie dědičnosti

CDBVariant

Požadavky

Hlavička: afxdb.h

CDBVariant::CDBVariant

Vytvoří objekt NULL CDBVariant .

CDBVariant();

Poznámky

Nastaví datový člen m_dwType na DBVT_NULL.

CDBVariant::Clear

Voláním této členské funkce vymažete CDBVariant objekt.

void Clear();

Poznámky

Pokud je hodnota datového členu m_dwType DBVT_DATE, DBVT_STRING nebo DBVT_BINARY, Clear uvolní paměť přidruženou ke členu sjednocovacího ukazatele. Clear nastaví m_dwType na DBVT_NULL.

Destruktor CDBVariant volá Clear.

CDBVariant::m_boolVal

Uloží hodnotu typu BOOL.

Poznámky

Datový m_boolVal člen patří do sjednocení. Před přístupem m_boolValnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_BOOL, m_boolVal bude obsahovat platnou hodnotu. V opačném případě bude mít přístup m_boolVal nespolehlivé výsledky.

CDBVariant::m_chVal

Uloží hodnotu typu unsigned char.

Poznámky

Datový m_chVal člen patří do sjednocení. Před přístupem m_chValnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_UCHAR, m_chVal pak obsahuje platnou hodnotu. V opačném případě přístup m_chVal vytvoří nespolehlivé výsledky.

CDBVariant::m_dblVal

Uloží hodnotu typu double.

Poznámky

Datový m_dblVal člen patří do sjednocení. Před přístupem m_dblValnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_DOUBLE, m_dblVal obsahuje platnou hodnotu. V opačném případě bude mít přístup m_dblVal nespolehlivé výsledky.

CDBVariant::m_dwType

Tento datový člen obsahuje datový typ pro hodnotu, která je aktuálně uložena ve sjednocovacího datového členu CDBVariant objektu.

Poznámky

Před přístupem k této sjednocovací jednotce musíte zkontrolovat hodnotu m_dwType , abyste zjistili, ke kterému datovému členu sjednocení se má získat přístup. Následující tabulka uvádí možné hodnoty pro m_dwType a odpovídajícího sjednocovacího datového člena.

m_dwType	Sjednocovacího datového člena
DBVT_NULL	Pro přístup není platný žádný člen sjednocení.
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

Uloží hodnotu typu float.

Poznámky

Datový m_fltVal člen patří do sjednocení. Před přístupem m_fltValnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_SINGLE, m_fltVal pak obsahuje platnou hodnotu. V opačném případě přístup m_fltVal vytvoří nespolehlivé výsledky.

CDBVariant::m_iVal

Uloží hodnotu typu short.

Poznámky

Datový m_iVal člen patří do sjednocení. Před přístupem m_iValnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_SHORT, m_iVal pak obsahuje platnou hodnotu. Jinak přístup m_iVal vytvoří nespolehlivé výsledky.

CDBVariant::m_lVal

Uloží hodnotu typu long.

Poznámky

Datový m_lVal člen patří do sjednocení. Před přístupem m_lValnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_LONG, m_lVal obsahuje platnou hodnotu, jinak přístup m_lVal vytvoří nespolehlivé výsledky.

CDBVariant::m_pbinary

Uloží ukazatel na objekt typu CLongBinary.

Poznámky

Datový m_pbinary člen patří do sjednocení. Před přístupem m_pbinarynejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_BINARY, m_pbinary pak obsahuje platný ukazatel. Jinak bude mít přístup m_pbinary nespolehlivé výsledky.

CDBVariant::m_pdate

Uloží ukazatel na objekt typu TIMESTAMP_STRUCT.

Poznámky

Datový m_pdate člen patří do sjednocení. Před přístupem m_pdatenejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_DATE, pak m_pdate obsahuje platný ukazatel. V opačném případě přístup m_pdate vytvoří nespolehlivé výsledky.

Další informace o datovém typu TIMESTAMP_STRUCT naleznete v tématu Datové typy jazyka C v dodatku D reference programátora ODBC v sadě Windows SDK.

CDBVariant::m_pstring

Uloží ukazatel na objekt typu CString.

Poznámky

Datový m_pstring člen patří do sjednocení. Před přístupem m_pstringnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_STRING, m_pstring obsahuje platný ukazatel; jinak bude mít přístup m_pstring nespolehlivé výsledky.

CDBVariant::m_pstringA

Uloží ukazatel na objekt ASCII CString .

Poznámky

Datový m_pstringA člen patří do sjednocení. Před přístupem m_pstringAnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_ASTRING, m_pstringA pak obsahuje platný ukazatel. Jinak bude mít přístup m_pstringA nespolehlivé výsledky.

CDBVariant::m_pstringW

Uloží ukazatel na široký objekt CString .

Poznámky

Datový m_pstringW člen patří do sjednocení. Před přístupem m_pstringWnejprve zkontrolujte hodnotu CDBVariant::m_dwType. Pokud m_dwType je nastavená hodnota DBVT_WSTRING, m_pstringW obsahuje platný ukazatel; jinak bude mít přístup m_pstringW nespolehlivé výsledky.

Viz také

Graf hierarchie
CRecordset – třída