Klasa CDBVariant
Reprezentuje typ danych wariantu dla klas MFC ODBC.
Składnia
class CDBVariant
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CDBVariant::CDBVariant | CDBVariant Tworzy obiekt. |
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CDBVariant::Clear | Czyści CDBVariant obiekt. |
Publiczne elementy członkowskie danych
| Nazwa/nazwisko | opis |
|---|---|
| CDBVariant::m_dwType | Zawiera typ danych aktualnie przechowywanej wartości. Wpisz DWORD. |
Członkowie unii publicznej
| Nazwa/nazwisko | opis |
|---|---|
| CDBVariant::m_boolVal | Zawiera wartość typu BOOL. |
| CDBVariant::m_chVal | Zawiera wartość typu unsigned char. |
| CDBVariant::m_dblVal | Zawiera wartość typu double. |
| CDBVariant::m_fltVal | Zawiera wartość typu float. |
| CDBVariant::m_iVal | Zawiera wartość typu short. |
| CDBVariant::m_lVal | Zawiera wartość typu long. |
| CDBVariant::m_pbinary | Zawiera wskaźnik do obiektu typu CLongBinary. |
| CDBVariant::m_pdate | Zawiera wskaźnik do obiektu typu TIMESTAMP_STRUCT. |
| CDBVariant::m_pstring | Zawiera wskaźnik do obiektu typu CString. |
| CDBVariant::m_pstringA | Przechowuje wskaźnik do obiektu CString ASCII. |
| CDBVariant::m_pstringW | Przechowuje wskaźnik do szerokiego obiektu CString . |
Uwagi
CDBVariant nie ma klasy bazowej.
CDBVariant jest podobny do COleVariant; CDBVariant jednak nie używa obiektu OLE. CDBVariant umożliwia przechowywanie wartości bez obaw o typ danych wartości. CDBVariant śledzi typ danych bieżącej wartości, która jest przechowywana w unii.
Klasa CRecordset wykorzystuje CDBVariant obiekty w trzech funkcjach składowych: GetFieldValue, GetBookmarki SetBookmark. Na przykład GetFieldValue umożliwia dynamiczne pobieranie danych w kolumnie. Ponieważ typ danych kolumny może nie być znany w czasie wykonywania, GetFieldValue używa CDBVariant obiektu do przechowywania danych kolumny.
Hierarchia dziedziczenia
CDBVariant
Wymagania
Nagłówek: afxdb.h
CDBVariant::CDBVariant
Tworzy obiekt NULL CDBVariant .
CDBVariant();
Uwagi
Ustawia element członkowski danych m_dwType na DBVT_NULL.
CDBVariant::Clear
Wywołaj tę funkcję składową, aby wyczyścić CDBVariant obiekt.
void Clear();
Uwagi
Jeśli wartość elementu członkowskiego danych m_dwType jest DBVT_DATE, DBVT_STRING lub DBVT_BINARY, Clear zwalnia pamięć skojarzona z elementem członkowskim wskaźnika unii. Clear ustawia m_dwType wartość DBVT_NULL.
Destruktor wywołuje metodę CDBVariant Clear.
CDBVariant::m_boolVal
Przechowuje wartość typu BOOL.
Uwagi
Element m_boolVal członkowski danych należy do unii. Przed uzyskaniem m_boolValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType zostanie ustawiona wartość DBVT_BOOL, m_boolVal będzie zawierać prawidłową wartość. W przeciwnym razie uzyskanie m_boolVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_chVal
Przechowuje wartość typu unsigned char.
Uwagi
Element m_chVal członkowski danych należy do unii. Przed uzyskaniem m_chValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_UCHAR, zawiera m_chVal prawidłową wartość. W przeciwnym razie uzyskanie m_chVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_dblVal
Przechowuje wartość typu double.
Uwagi
Element m_dblVal członkowski danych należy do unii. Przed uzyskaniem m_dblValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli ustawiono wartość DBVT_DOUBLE, m_dblVal zawiera prawidłową wartość. W m_dwType przeciwnym razie uzyskanie m_dblVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_dwType
Ten element członkowski danych zawiera typ danych dla wartości, która jest obecnie przechowywana w składowej CDBVariant danych unii obiektu.
Uwagi
Przed uzyskaniem dostępu do tej unii należy sprawdzić wartość m_dwType , aby określić, do którego elementu członkowskiego danych unii uzyskać dostęp. W poniższej tabeli wymieniono możliwe wartości dla m_dwType i odpowiadające mu składowe danych unii.
| m_dwType | Składowa danych unii |
|---|---|
| DBVT_NULL | Żaden członek unii nie jest ważny w celu uzyskania dostępu. |
| 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
Przechowuje wartość typu float.
Uwagi
Element m_fltVal członkowski danych należy do unii. Przed uzyskaniem m_fltValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_SINGLE, m_fltVal zawiera prawidłową wartość. W przeciwnym razie uzyskanie m_fltVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_iVal
Przechowuje wartość typu short.
Uwagi
Element m_iVal członkowski danych należy do unii. Przed uzyskaniem m_iValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_SHORT, m_iVal zawiera prawidłową wartość. W przeciwnym razie uzyskanie m_iVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_lVal
Przechowuje wartość typu long.
Uwagi
Element m_lVal członkowski danych należy do unii. Przed uzyskaniem m_lValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_LONG, m_lVal zawiera prawidłową wartość. W przeciwnym razie uzyskanie m_lVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_pbinary
Przechowuje wskaźnik do obiektu typu CLongBinary.
Uwagi
Element m_pbinary członkowski danych należy do unii. Przed uzyskaniem m_pbinarydostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_BINARY, m_pbinary zawiera prawidłowy wskaźnik. W przeciwnym razie uzyskanie m_pbinary dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_pdate
Przechowuje wskaźnik do obiektu typu TIMESTAMP_STRUCT.
Uwagi
Element m_pdate członkowski danych należy do unii. Przed uzyskaniem m_pdatedostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_DATE, m_pdate zawiera prawidłowy wskaźnik. W przeciwnym razie uzyskanie m_pdate dostępu spowoduje wygenerowanie niewiarygodnych wyników.
Aby uzyskać więcej informacji na temat typu danych TIMESTAMP_STRUCT, zobacz temat Typy danych języka C w dodatku D dokumentacji programisty ODBC w zestawie Windows SDK.
CDBVariant::m_pstring
Przechowuje wskaźnik do obiektu typu CString.
Uwagi
Element m_pstring członkowski danych należy do unii. Przed uzyskaniem m_pstringdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli ustawiono wartość DBVT_STRING, m_pstring zawiera prawidłowy wskaźnik. W m_dwType przeciwnym razie uzyskanie m_pstring dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_pstringA
Przechowuje wskaźnik do obiektu CString ASCII.
Uwagi
Element m_pstringA członkowski danych należy do unii. Przed uzyskaniem m_pstringAdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_ASTRING, m_pstringA zawiera prawidłowy wskaźnik. W przeciwnym razie uzyskanie m_pstringA dostępu spowoduje wygenerowanie niewiarygodnych wyników.
CDBVariant::m_pstringW
Przechowuje wskaźnik do szerokiego obiektu CString .
Uwagi
Element m_pstringW członkowski danych należy do unii. Przed uzyskaniem m_pstringWdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli ustawiono wartość DBVT_WSTRING, m_pstringW zawiera prawidłowy wskaźnik. W m_dwType przeciwnym razie uzyskanie m_pstringW dostępu spowoduje wygenerowanie niewiarygodnych wyników.