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.