CDBVariant – třída

Poznámka:

Knihovna MFC (Microsoft Foundation Classes) se nadále podporuje. Už ale nepřidáme funkce ani aktualizujeme dokumentaci.

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